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Foreword 



rd , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project: Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

32.111-1 "Fault Management; Part 1 : 3G fault management requirements" . 

32. 111-2 "Fault Management; Part 2: Alarm Integration Reference Point (IRP): Information Service (IS)". 

32.111-6 "Fault Management; Alarm Integration Reference Point (IRP); Solution Set (SS) 

definitions". 

The present document is part of a TS-family, which describes the requirements and information model necessary for 
Telecommunications Management (TM). The TM principles and TM architecture are specified in 3GPP TS 32.101 [1] 
and 3GPPTS 32.102 [2]. 

A communications system is composed of a multitude of Network Elements (NE) of various types and, typically, 
different vendors, which inter-operate in a coordinated manner in order to satisfy the network users' communication 
requirements. 

The occurrence of faults in an NE may cause deterioration or loss of this NE's function. Fault Management is the 
functional area, which allows the operator to detect the occurrence of faults in the network in real-time. Configuration 
Management and Performance Management are two more functional areas, which require the operator to be alerted to 
certain conditions in the network. 

A standard general-purpose mechanism for the management of logs containing selected notifications from the network 
is required to provide an ability to perform historical analysis on faults and conditions, which occurred in the network. 
The TS 32.33x-series, constituting the Notification Log IRP, sets forth such a mechanism - and Annex B of the present 
document contains the XML definition related to Alarm IRP notifications. 
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Scope 



The present document contains the Solution Sets for the IRP whose semantics is specified in Alarm IRP: Information 

Service (TS 32.111-2 [4]). 

These Solution Set specifications are related to 3GPP TS 32.1 1 1-2 V10.2.X. 



2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

For a specific reference, subsequent revisions do not apply. 

For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[I] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[2] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[3] 3GPP TS 32.1 1 1-1: "Telecommunication management; Fault Management; Part 1: 3G fault 

management requirements". 

[4] 3GPP TS 32.1 1 1-2: "Telecommunication management; Fault Management; Part 2: Alarm 

Integration Reference Point: Information Service (IS)". 

[5] 3GPP TS 32.150: "Telecommunication management; Integration Reference Point (IRP) Concept 

and definitions". 

[6] 3GPP TS 32.300: "Telecommunication management; Configuration Management (CM); Name 

convention for Managed Objects". 

[7] 3GPP TS 32.302: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Information Service (IS)". 

[8] 3GPP TS 32.306: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Solution Set (SS) definitions". 

[9] 3GPP TS 32.31 1: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Requirements". 

[10] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Information Service (IS)". 

[II] 3GPP TS 32.316: "Telecommunication management; Generic Integration Reference Point (IRP) 
management: Solution Set (SS) definitions". 

[12] 3GPP TS 32.331: "Telecommunication management; Notification Log (NL) Integration Reference 

Point (IRP): Requirements". 

[13] 3GPP TS 32.336: "Telecommunication management; Notification Log (NL) Integration Reference 

Point (IRP): Solution Set (SS) definitions". 

[14] OMG TC Document telecom/98-1 1-01: "OMG Notification Service". 

http://www.omg.org/technologv/documents/ 
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[15] OMG CORBA Services: "Common Object Services Specification, Update: November 22, 1996" 

(Clause 4 contains the Event Service specification), http://www.omg.org/technologv/documents/ 

[16] W3C SOAP 1.1 specification ( http://www.w3.org/TR/2000/NOTE-SOAP-20000508/) 

[17] W3C SOAP 1.2 specification ( http://www.w3.org/TR/soapl2-partl/) 

[18] W3C WSDL 1 . 1 specification ( http://www.w3 .org/TR/200 l/NOTE-wsdl-200 1 03 1 5) 

[19] W3C XPath 1.0 specification (http://www.w3.org/TR/1999/REC-xpath-19991 1 16 ) 

3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in 3GPP TS 32.101 [1], 3GPP TS 32.102 [2], 
3GPPTS 32.111-1 [3], 3GPPTS32.il 1-2 [4], 3GPP TS 32.150 [5] and 3GPPTS 32.331 [12] apply. 

IRP document version number string 

The IRP document version number (sometimes called 'IRP version' or 'version number') string is used to identify the 
present document. The definition of 'IRP document version number string' in 3GPP TS 32.3 1 1 [9] provides the rule 
to derive such a string. 

This string is used for the return value of get_alarm_irp_versions(). It is used as return value of 
get_notification_categories() if the Notification IRP supports the emission of notifications defined by this Alarm 
IRP version. It is also used in the domain_name attribute of a structured event carrying alarm information defined by 
this Alarm IRP version. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CORBA Common Object Request Broker Architecture 

IDL Interface Definition Language 

IRP Integration Reference Point 

IS Information Service 

MOC Managed Object Class 

MOI Managed Object Instance 

NE Network Element 

NL Notification Log 

OMG Object Management Group 

SS Solution Set 

TMN Telecommunications Management Network 

UML Unified Modelling Language 

WSDL Web Service Description Language 

XML extensible Markup Language 



4 Solution Set Definitions 

This specification defines the following 3GPP Alarm IRP Solution Set Definitions: 

Annex A provides the CORBA Solution Set. 
Annex B provides the XML Definitions. 
Annex C provides the SOAP Solution Set. 
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Annex A (normative): 
CORBA Solution Set 



This annex contains the CORBA Solution Set for the IRP whose semantics is specified in Alarm IRP: Information 

Service (TS 32.111-2 [4]). 



A.1 Architectural Features 

The overall architectural feature of Alarm IRP is specified in 3G TS 32. 1 11 -2 [4] . This clause specifies features that are 
specific to the CORBA SS. 

A.1 .1 Syntax for Distinguished Names 

The syntax of a Distinguished Name is defined in 3GPP TS 32.300 [6]. 

A. 1.2 Notification Services 

In implementations of CORBA SS, IRP Agent conveys Alarm Information to IRPManager via OMG Notification 
Service (OMG Notification Service [14]). 

OMG Event Service [15] provides event routing and distribution capabilities. OMG Notification Service provides, in 
addition to Event Service, event filtering and Quality Of Service (QOS) as well. 

A necessary and sufficient sub set of OMG Notification Services shall be used to support 
AlarmlRPNotif ications notifications as specified in 3G TS 32.111-2 [4]. 

A.1. 3 Push and Pull Style 

OMG Notification Service defines two styles of interaction. One is called push style. In this style, IRP Agent pushes 
notifications to IRPManager as soon as they are available. The other is called pull style. In this style, IRP Agent keeps 
the notifications till IRPManager requests for them. 

This CORBA SS specifies that support of Push style is Mandatory (M) and that support of Pull style is Optional (O). 

A.1 .4 Support multiple notifications in one push operation 

For efficiency reasons, IRP Agent may send multiple notifications using one single push operation. To pack multiple 
notifications into one push operation, IRP Agent may wait and not invoke the push operation as soon as notifications 
are available. To avoid IRP Agent to wait for an extended period of time that is objectionable to IRPManager, IRP Agent 
shall implement an IRP Agent wide timer configurable by administrator. On expiration of this timer, IRP Agent shall 
invoke push if there is at least one notification to be conveyed to IRPManager. This timer is re-started after each push 
invocation. 

A. 1.5 AlarmlRPNotifications Interface 

OMG CORBA Notification push operation is used to realise the notification of AlarmlRPNotif ications. All the 
notifications in this interface are implemented using this push_structured_event method. 

A.1. 5.1 Method push (M) 

module CosNotifyComm { 



£75/ 



3GPP TS 32.111-6 version 10.4.0 Release 10 



ETSI TS 132 111-6 VI 0.4.0 (2011-10) 



Interface SequencePushConsumer : NotifyPublish { 
void push_structured_events { 

in CosNotif ication: :EventBatch notifications) 
raises { CosEventComm: : Disconnected) ; 

} ; // SequencePushConsumer 

} ; // CosNotifyComm 



NOTE 1: The push_structured_events method takes an input parameter of type EventBatch as defined 
in the OMG CosNotif ication module (OMG Notification Service [14]). This data type is the same 
as a sequence of Structured Events. Upon invocation, this parameter will contain a sequence of Structured 
Events being delivered to IRPManager by IRP Agent to which it is connected. 

NOTE 2: The maximum number of events that will be transmitted within a single invocation of this operation is 
controlled by IRP Agent wide configuration parameter. 

NOTE 3: The amount of time the supplier (IRP Agent) of a sequence of Structured Events will accumulate 
individual events into the sequence before invoking this operation is controlled by IRP Agent wide 
configuration parameter as well. 

NOTE 4: IRP Agent may push EventBatch with only one Structured Event. 

A.1.6 Filter 

IRP Agent shall optionally support alarm filtering based on IRPManager" s supplied alarm filter constraints (e.g. as 
parameter in subscribe() of 3G TS 32.302 [7]. Alarm filtering can be applied in the following cases: 

It is applicable to alarms emitted by IRP Agent via AlarmlRPNotif ications. IRPManager supplies alarm 
filter constraint via the subscribe method. This filter is effective during the period of subscription. 

It is applicable to alarms returned by IRP Agent via the out parameter of get_alarm_list method. 
IRPManager supplies alarm filter constraint via the get_alarTn_list method. This filter is effective only for 
this method invocation. 

It is applicable to the calculation of alarm counts returned by IRP Agent via the out parameters of 
get_alarm_count method. IRPManager supplies alarm filter constraint via the get_alarm_count 
method. This filter is effective only for this method invocation. 

This SS shall use of filter constraint grammar specified by reference OMG Notification Service [14]. The name of the 
grammar is called "EXTENDED_TCL". See clause 2.4, Default Filter Constraint Language in OMG Notification Service 
[14]. This SS shall use this grammar only. 



A.2 Mapping 

A.2.1 Operation and Notification mapping 

Alarm IRP: IS 3G TS 32.111-2 [4] defines semantics of operation and notification visible across the Alarm IRP. Table 
A. 2. 1.1 indicates mapping of these operations and notifications to their equivalents defined in this SS. 

Table A.2. 1.1 : Mapping from IS Notification/Operation to SS equivalents 



IS Operation/ notification 3G TS 32.111- 
2 [4] 


SS Method 


Qualifier 


acknowledgeAlarms 


acknowledge alarms 


M 


unacknowledgeAlarms 


unacknowledge alarms 





getAlarmList 


get alarm list 


M 


getlRPVersion (note) 


get alarm irp versions 


M 
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getAlarmCount 


get alarm count 





setComment 


comment alarms 





clearAlarms 


clear alarms 





getOperationProfile (note) 


get alarm irp operations profile 





getNotificationProfile (note) 


get alarm irp notification profile 





notifyNewAlarm 


push_structured_event 

Note that OMG Notification Service OMG Notification Service [14] 

defines this method. 

See clause A.3.1 


M 


notifyClearedAlarm 


push_structured_event 
See clause A.3.1 


M 


notifyChangedAlarm 


push_structured_event 
See clause A.3.1 


M 


notifyAckStateChanged 


push_structured_event 
See clause A.3.1 


M 


notifyAlarmListRebuilt 


push_structured_event 
See clause A.3.1 


M 


notifyComments 


push_structured_event 
See clause A.3.1 





notifyPotentialFaultyAlarmList 


push_structured_event 
See clause A.3.1 





notifyCorrelatedNotificationChanged 


push_structured_event 
See clause A.3.1 





NOTE: This operation is of IVIanagedGenericIRP IOC specified in [10]. The AlarmlRP IOC of [4] inherits from it. 



A.2.2 Operation parameter mapping 



Reference 3G TS 32.1 1 1-2 [4] defines semantics of parameters carried in operations across the Alarm IRP. The 
following set of tables indicates the mapping of these parameters, as per operation, to their equivalents defined in this 
SS. 

Table A.2.2. 1 : Mapping from IS acknowledgeAlarms parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarmlnformationAndSeverityReferenceList 


Alarm IRPConstDefs;:AlarmlnformationldAndSevSeq 

alarm_information_id_and_sev_list 

Note: perceivedSeverity is optional 

{ alarmld - IVIandatory; 

perceivedSeverity - Optional 

} 


M 


ackUserld 


string ack user id 


M 


ackSystemId 


ManagedGenericlRPConstDefs::StringOpt ack system id 





badAlarmlnformationReferenceList 


AlarmlRPConstDefs::BadAcknowledgeAlarmlnfoSeq 
bad ack alarm info list 


M 


status 


l\/lanagedGenericlRPConstDefs::Signal 

Exceptions: 

AcknowledgeAlarms, 

l\/lanagedGenericlRPSystem::ParameterNotSupported, 

l\/lanagedGenericlRPSystem::lnvalidParameter 


M 
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Table A.2.2.2: Mapping from IS unacknowledgeAlarms parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarmlnformationReferenceList 


AlarmlRPConstDefs::AlarmlnformationldSeq alarm information id list 


M 


ackUserld 


string ack user id 


M 


ackSystemId 


IVIanagedGenericlRPConstDefs::StringOpt ack system id 





badAlarmlnformationReferenceList 


AlarmlRPConstDefs:: BadAlarmlnformationldSeq 
bad alarm information id list 


M 


status 


IVIanagedGenericlRPConstDefs::Signal 

Exceptions: 

UnacknowledgeAlarms, 

IVIanagedGenericlRPSystem::OperationNotSupported, 

IVIanagedGenerJclRPSystem::ParameterNotSupported, 

IVIanagedGenerJclRPSystem::lnvalidParameter 


M 



Table A.2.2.3: IVIapping from IS getAlarmList parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarmAckState, filter 


ManagedGenericlRPConstDefs::StringOpt filter 





baseObjectClass, 
baseObjectlnstance 


AlarmlRPConstDefs::DNOptbase_object 




(Note 1) 


alarmlnformation List 


Return value of type AlarmlRPConstDefs::AlarmlnformationSeq (Note 2) 


M 


status 


Exceptions: 

GetAlarmList, 

FilterComplexityLimit, 

l\/lanagedGenericlRPSystem::ParameterNotSupported, 

l\/lanagedGenericlRPSystem::lnvalidParameter 


M 


Note 1 : If notification notif yAlarmListRebuilt supports indicating that only a part of the alarm list has been 
rebuilt then this parameter shall be supported. 

Note 2: Each Structured Event of AlarmlRPConstDefs::AlarmlnformationSeq shall have the fields defined in 
Table A.2.2.4 or Table A.2.2.5. 
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Table A.2.2.4: Definition of a Structured Event of AlarmlRPConstDefs::AlarmlnformationSeq for 

alarms not related to security 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
attribute. 


domain_name 






notificationlype 


type_name 


M 


The parameter carries 

. NOTIFY_FM_NEW_ALARM of interface 

Motif icationType of module Alarm IRPConstDefs in case 
the alarm has not yet changed and has not yet been 
cleared. 

. NOTIFY_FM_CHANGED_ALARM of interface 

Motif icationType of module Alarm IRPConstDefs in case 
the alarm has changed but has not yet been cleared. 

. MOTIFY_FM_CLEARED_ALARM of interface 

Motif icationType of module Alarm IRPConstDefs in case 
the alarm has been cleared but not yet acknowledged. 


alarmType 


See Table A.2.3.1 


M 


See Table A.2.3.1 


There is no 
corresponding SS 
attribute. 


variable Header 






objectClass, 
objectlnstance 


See Table A.2.3.1 


M 


See Table A.2.3.1 


notificationid 


See Table A.2.3.1 


M 


See Table A.2.3.1 


eventTime 


See Table A.2.3.1 





Value of MV pair is a IRPTime of module 
ManagedGenericlRPConstDefs. 

The parameter carries the 

• alarmRaisedTime in case notificationType carries 
MOTIFY_FM_MEW_ALARM 

• alarmChangedTime in case notificationType carries 
MOTIFY_FM_CHAMGED_ALARM 

• alarmClearedTime in case notificationType carries 
NOTIFY FM CLEARED ALARM 


systemDN 


See Table A.2.3.1 


M 


See Table A.2.3.1 


alarmld 


See Table A.2.3.1 


M 


See Table A.2.3.1 


alarm RaisedTime 


One NV pair of 

filterable_ 

bodyjields 


M 


Name of NV pair is the ALARM_RAISED_TIME of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a IRPTime of module 
IVIanagedGenericlRPConstDefs. 


alarmChangedTime 


One NV pair of 

filterable_ 

bodyjields 





Name of NV pair is the ALARIVI_CHANGED_TIME of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a IRPTime of module 
IVIanagedGenericlRPConstDefs. 


alarmClearedTime 


One NV pair of 

filterable_ 

bodyjields 


M 


present if related alarm was cleared; not present if related alarm 
was not cleared 

Name of NV pair is the ALARIVI_CLEARED_TIME of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a IRPTime of module 
ManagedGenericlRPConstDefs. 


probableCause 


See Table A.2.3.1 


M 


See Table A.2.3.1 


perceivedSeverity 


See Table A.2.3.1 


M 


See Table A.2.3.1 


rootCauselndicator 


See Table A.2.3.1 





See Table A.2.3.1 


specificProblem 


See Table A.2.3.1 





See Table A.2.3.1 


backedUpStatus 


See Table A.2.3.1 





See Table A.2.3.1 


trendlndication 


See Table A.2.3.1 





See Table A.2.3.1 


thresholdlnfo 


See Table A.2.3.1 





See Table A.2.3.1 


stateChangeDefinition 


See Table A.2.3.1 





See Table A.2.3.1 


monitoredAttributes 


See Table A.2.3.1 





See Table A.2.3.1 


proposedRepairActions 


See Table A.2.3.1 





See Table A.2.3.1 
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IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


additionalText 


See Table A.2.3.1 





See Table A.2.3.1 


additionallnformation 


See Table A.2.3.1 





See Table A.2.3.1 


ackTime 


See Table A.2.3.3 


M 


present if related alarm was acknowledged or unacknowledged; 
not present if related alarm was not acknowledged or 
unacknowledged 

See Table A.2.3.3 


ackUserld 


See Table A.2.3.3 


M 


present if related alarm was acknowledged or unacknowledged; 
not present if related alarm was not acknowledged or 
unacknowledged 

See Table A.2.3.3 


ackSystemId 


See Table A.2.3.3 





optionally present if related alarm was acknowledged or 
unacknowledged; not present if related alarm was not 
acknowledged or unacknowledged 

See Table A.2.3.3 


ackState 


See Table A.2.3.3 


M 


present if related alarm was acknowledged or unacknowledged; 
not present if related alarm was not acknowledged or 
unacknowledged 

See Table A.2.3.3 


clearUserld 


See Table A.2.3.4 





optionally present if related alarm was cleared; not present if 
related alarm was not cleared 

See Table A.2.3.4 


clearSystemld 


See Table A.2.3.4 





optionally present if related alarm was cleared; not present if 
related alarm was not cleared 

See Table A.2.3.4 


backUpObject 


See Table A.2.3.1 





See Table A.2.3.1 


correlatedNotifications 


See Table A.2.3.1 





See Table A.2.3.1 


comments 


See Table A.2.3.7 


M 


present if related alarm was commented; not present if related 
alarm was not commented 

See Table A.2.3.7 


There is no 
corresponding IS 
attribute. 


remaining_ body 
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Table A.2.2.5: Definition of a Structured Event of AlarmlRPConstDefs::AlarmlnformationSeq for 

alarms related to security 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
attribute. 


domain_name 






notificationlype 


type_name 


M 


See Table A.2.3.1 

The parameter carries 

• NOTIFY_FM_NEW_ALARM of interface NotificationType 
of module AlarmlRPConstDefs in case the alarm has not 
yet changed and has not yet been cleared. 

• NOTIFY_FM_CHANGED_ALARM of interface 
NotificationType of module AlarmlRPConstDefs in case 
the alarm has changed but has not yet been cleared. 

• NOTIFY_FM_CLEARED_ALARM of interface 
NotificationType of module AlarmlRPConstDefs in case 
the alarm has been cleared but not yet acknowledged. 


alarmType 


See Table A.2.3.1 


M 


See Table A.2.3.1 


There is no 
corresponding SS 
attribute. 


variable Header 






objectClass, 
objectlnstance 


See Table A.2.3.1 


M 


See Table A.2.3.1 


notificationid 


See Table A.2.3.1 


M 


See Table A.2.3.1 


eventTime 


See Table A.2.3.1 





See Table A.2.3.1 

The parameter carries the 

• alarmRaisedTime in case notificationType carries 
NOTIFY_FM_NEW_ALARM 

• alarmChangedTime in case notificationType carries 
NOTIFY_FM_CHANGED_ALARM 

• alarmClearedTime in case notificationType carries 
NOTIFY FM CLEARED ALARM 


systemDN 


See Table A.2.3.1 


M 


See Table A.2.3.1 


alarmld 


See Table A.2.3.1 


M 


See Table A.2.3.1 


alarm RaisedTime 


One NV pair of 

filterable_ 

bodyjields 


M 


Name of NV pair is the ALARM_RAISED_TIIVIE of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a IRPTime of module 
ManagedGenericI RPConstDefs. 


alarmChangedTime 


One NV pair of 

filterable_ 

bodyjields 





Name of NV pair Is the ALARM_CHANGED_TIME of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a IRPTime of module 
ManagedGenericI RPConstDefs. 


alarmClearedTime 


One NV pair of 

filterable_ 

bodyjields 


M 


present if related alarm was cleared; not present if related alarm 
was not cleared 

Name of NV pair is the ALARM_CLEARED_TIME of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a IRPTime of module 
ManagedGenericI RPConstDefs. 


probableCause 


See Table A.2.3.1 


M 


See Table A.2.3.1 


perceivedSeverity 


See Table A.2.3.1 


M 


See Table A.2.3.1 


rootCauselndicator 


See Table A.2.3.1 





See Table A.2.3.1 


specificProblem 


See Table A.2.3.1 





See Table A.2.3.1 


additionalText 


See Table A.2.3.1 





See Table A.2.3.1 


additionallnformation 


See Table A.2.3.1 





See Table A.2.3.1 


ackTIme 


See Table A.2.3.3 


M 


present if related alarm was acknowledged or unacknowledged; 
not present if related alarm was not acknowledged or 
unacknowledged 
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IS Parameters 


OWIG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 








See Table A.2.3.3 


ackUserld 


See Table A.2.3.3 


M 


present if related alarm was acknowledged or unacknowledged; 
not present if related alarm was not acknowledged or 
unacknowledged 

See Table A.2.3.3 


ackSystemId 


See Table A.2.3.3 





optionally present if related alarm was acknowledged or 
unacknowledged; not present if related alarm was not 
acknowledged or unacknowledged 

See Table A.2.3.3 


ackState 


See Table A.2.3.3 


M 


present if related alarm was acknowledged or unacknowledged; 
not present if related alarm was not acknowledged or 
unacknowledged 

See Table A.2.3.3 


clearUserld 


See Table A.2.3.4 





optionally present if related alarm was cleared; not present if 
related alarm was not cleared 

See Table A.2.3.4 


clearSystemId 


See Table A.2.3.4 





optionally present if related alarm was cleared; not present if 
related alarm was not cleared 

See Table A.2.3.4 


correlatedNotifications 


See Table A.2.3.1 





See Table A.2.3.1 


comments 


See Table A.2.3.7 


M 


present if related alarm was commented; not present if related 
alarm was not commented 

See Table A.2.3.7 


serviceUser 


See Table A.2.3.2 


M 


See Table A.2.3.2 


serviceProvider 


See Table A.2.3.2 


M 


See Table A.2.3.2 


secu rityAlarm Detector 


See Table A.2.3.2 


M 


See Table A.2.3.2 


There is no 
corresponding IS 
attribute. 


remaining_ body 







Table A.2.2.6: Mapping from IS getAlarmCount parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarmAckState, filter 


ManagedGenericlRPConstDefs:;StringOpt filter 





criticalCount, majorCount, 
minorCount, warningCount, 
indeterminateCount, clearedCount 


long critical_count, long major_count, long minor_count, long 
warning_count, long indeterminate_count, long cleared_count 


M 


status 


Exceptions: 

GetAlarmCount, 

FilterComplexityLimit, 

l\/lanagedGenericlRPSystem::OperationNotSupported, 

ManagedGenericlRPSystem::ParameterNotSupported, 

ManagedGenericlRPSystem::lnvalidParameter 


M 



Table A.2.2.7: Mapping from IS getiRPVerslon parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


versionNumberSet 


Return value of type ManagedGenericlRPConstDefs;:VersionNumberSet 


M 


status 


Exceptions: 
GetAlarmlRPVersions 


M 
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Table A.2.2.8: Mapping from IS setcomment parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarmlnformationReferenceList 


AlarmlRPConstDefs::AlarmlnformationldSeq alarm information id list 


M 


commentUserld 


string comment user id 


M 


commentSystemId 


ManagedGenericlRPConstDefs::StringOpt comment system id 





commentText 


string comment text 


M 


badAlarmlnformationReferenceList 


AlarmlRPConstDefs::BadAlarmlnformationldSeq 
bad alarm information id list 


M 


status 


IVIanagedGenericlRPConstDefs::Signal 

Exceptions: 

CommentAlarms, 

IVIanagedGenericlRPSystem::OperationNotSupported, 

ManagedGenericlRPSystem::ParameterNotSupported, 

IVIanagedGenericlRPSystem::lnvalidParameter 


M 



Table A.2.2.9: IVIapping from IS getoperatlonProflle parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


irpVersion 


ManagedGenericlRPConstDefs::VersionNumber 
alarm irp version 


M 


operationNameProfile, 
operationParameterProfile 


Return value of type ManagedGenericlRPConstDefs::MethodList 


M 


status 


Exceptions: 

GetAlarmlRPOperationsProfile, 

ManagedGenericlRPSystem::OperationNotSupported, 

IVIanagedGenerJclRPSystem::lnvalidParameter 


M 



Table A.2.2.10: IVIapping from IS getNotificationProfile parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


irpVersion 


ManagedGenericlRPConstDefs::VersionNumber 
alarm irp version 


M 


notificationNameProfile, 
notificationParameterProfile 


Return value of type 
ManagedGenerJclRPConstDefs::MethodList 


M 


status 


Exceptions: 

GetAlarmlRPNotificationProfile, 

ManagedGenerJclRPSystem;:OperationNotSupported, 

ManagedGenericlRPSystem::lnvalidParameter 


M 



Table A.2.2.11 : Mapping from IS clearAlarms parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarm 1 nformation ReferenceList 


AlarmlRPConstDefs::AlarmlnformationldSeq alarm information id list 


M 


clearUserld 


string clear user id 


M 


clearSystemId 


string clear system id 





badAlarmlnformationReferenceList 


AlarmlRPConstDefs:: BadAlarmlnformationldSeq 
bad alarm information id list 


M 


status 


IVIanagedGenericlRPConstDefs::Signal 

Exceptions: 

ClearAlarms, 

IVIanagedGenericlRPSystem::OperationNotSupported, 

IVIanagedGenericlRPSystem::ParameterNotSupported, 

IVIanagedGenericlRPSystem::lnvalidParameter 


M 
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A.2.3 Notification parameter mapping 



Reference 3G TS 32.1 1 1-2 [4] defines semantics of parameters carried in notifications. The following tables indicate 
the mapping of these parameters to their OMG CORE A Structured Event (defined in OMG Notification Service [14]) 
equivalents. The composition of OMG Structured Event, as defined in the OMG Notification Service [14], is: 



Header 



Body 



Fixed Header 

domain_name 

type_name 

event_name 
Variable Header 

f ilterable_body_f ields 
remaining_body 



The following tables list all OMG Structured Event attributes in the second column. The first column identifies the 
Alarm IRP: IS [4] defined notification parameters. 

Table A.2.3. 1 : Mapping for notif yNewAlarm (to carry non-security-related alarms) 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding SS 
attribute. 


domain_name 




It carries the IRP document version number string. See sub- 
clause 3.1. 

It indicates the syntax and semantics of the Structured Event as 
defined by this specification. 


notificationType 


type_name 


M 


This is the NOTIFY_FM_NEW_ALARM of interface 
NotificationType of module AlarmlRPConstDefs. 


alarmType 


event_name 


M 


It identifies one of the following: 
communications alarm, 
processing error alarm, 
environmental alarm, 
quality of service alarm and 
equipment alarm. 

It is a string defined by interface AlarmType of module 
AlarmlRPConstDefs. 


There is no 
corresponding SS 
attribute. 


variable Header 






objectCiass, 
objectlnstance 


One NV pair of 
filterable_body_fields 


M 


NV stands for name-value pair. Order arrangement of NV pairs 
is not significant. The name of NV-pair is always encoded in 
string. 

Name of NV pair is the MANAGED_OBJECT_INSTANCE of 
interface AttributeNameValue of module 
Notification IRPConstDefs. 

Value of NV pair is a string. 


notificationid 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NOTIFICATIONJD of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a long. 


eventTime 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the EVENT_TII\/IE of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a IRPTime of module 
ManagedGenericI RPConstDefs. 


systemDN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the SYSTEI\/I_DN of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a string. 
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IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


probableCause 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the PROBABLE_CAUSE of interface 
AttributeNameValue of module Alarm IRPConstDefs. 

Value of NV pair is a short defined by interface ProbableCause 
of module AlarmlRPConstDefs. 


perceivedSeverity 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the PERCEIVED_SEVERITY of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a short defined by interface 
PerceivedSeverity of module AlarmlRPConstDefs. 


rootCauselndicator 


One NV pair of 
filterable_body_fields 





Name of NV pair is the ROOT_CAUSE_INDICATOR of 
interface AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a boolean defined by interface 
RootCauselndicator of module AlarmlRPConstDefs. 


specificProblem 


One NV pair of 
remaining_body 





Name of NV pair is the SPECIFIC_PROBLEM of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a string. 


correlatedNotifications 


One NV pair of 
remaining_body 





Name of NV pair is the CORRELATED_NOTIFICATIONS of 
interface AttributeNameValue. 

Value of NV pair is a CorrelatedNotificationSet of module 
AlarmlRPConstDefs. 


backedUpStatus 


One NV pair of 
remaining_body 





Name of NV pair is the BACKED_UP_STATUS of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a boolean BackedUpStatus of module 
AlarmlRPConstDefs. 


backUpObject 


One NV pair of 
remaining_body 





Name of NV pair is the BACK_UP_OBJECT of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a string carrying of DN of the back-up 
object. See 3G TS 32.300 [6] for the DN string representation. 


trendlndication 


One NV pair of 
remaining_body 





Name of NV pair is the TRENDJNDICATION of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is an enum Trendlndication of module 
AlarmlRPConstDefs. 


thresholdlnfo 


One NV pair of 
remaining_body 





Name of NV pair is the THRESHOLDJNFO of interface 
ParameterNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a Thresholdlnfo of module 
AlarmlRPConstDefs. 


stateChangeDefinition 


One NV pair of 
remaining_body 





Name of NV pair is the STATE_CHANGE_DEFINITION of 
interface AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is an AttributeChangeSet of module 
AlarmlRPConstDefs. 


monitoredAttributes 


One NV pair of 
remaining_body 





Name of NV pair is the MONITORED_ATTRIBUTES of 
interface AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is an AttributeSet of module 
AlarmlRPConstDefs. 


proposedRepairActions 


One NV pair of 
remaining_body 





Name of NV pair is the PROPOSED_REPAIR_ACTIONS of 
interface AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a string. 


additionalText 


One NV pair of 
remaining_body 





Name of NV pair is the ADDITIONAL_TEXT of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a string. 
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IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


additionallnformation 


One or more NV 
pairs of 
remaining_body 





3GPP defines two Additional Information (Al) NV pairs for 

carrying vendor-specific (VS) perceived severity and alarm 

type. 

The names of these two NV pairs are: 

• Al VS PERCEIVED SEVERITY 

• AI_VS_ALARM_TYPE 

of interface Additionallnformation of module 

AlarmlRPConstDefs. 

The values of these two NV pairs are vendor defined. 

Other Al NV pairs are permitted to capture specific information. 

To be easily identified as vendor specific, the name value of 

these NV pairs should take the form of "ai_vs_<non-empty 

string>". 

The value of this NV pair is vendor defined. 


alarmld 


One NV pair of 
remaining_body 


M 


Name of NV pair is the ALARM_ID of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a string. 

If the string is a zero-length string or if this NV pair is absent, 
the default semantics is that alarmld is a concatenation of 
managedObjectlnstance, eventType, probableCause and 
specificProblem, if present, of this Structured Event. Since 
probableCause is encoded as a short, it shall be converted into 
string before concatenation. The resultant string shall not 
contain spaces. 



Table A.2.3.2: Mapping for notifyNewAlarm (to carry security alarm) 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding SS 
attribute. 


domain_name 




It carries the IRP document version number string. See sub- 
clause 3.1. 

It indicates the syntax and semantics of the Structured Event 
as defined by this specification. 


notificationType 


type_name 


M 


This is the NOTIFY_FM_NEW_ALARM of interface 
NotificationType of module AlarmlRPConstDefs. 


alarmType 


event_name 


M 


It identifies one of the following: 

Integrity violation, operational violation, physical violation, 

security violation and time domain violation. 

It is a string defined by interface AlarmType of module 
AlarmlRPConstDefs. 


There is no 
corresponding SS 
attribute. 


variable Header 






objectClass, 
objectlnstance 


One NV pair of 
filterable_body_fields 


M 


NV stands for name-value pair. Order arrangement of NV pairs 
is not significant. The name of NV-pair is always encoded in 
string. 

Name of NV pair is the MANAGED_OBJECT_INSTANCE of 
interface AttributeNameValue of module 
Notification IRPConstDefs. 

Value of NV pair is a string. 


notificationid 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NOTIFICATIONJD of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a long. 
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IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


eventTime 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is tlie EVENT_TII\/IE of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a IRPTime of module 
ManagedGenericI RPConstDefs. 


systemDN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the SYSTEM_DN of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a string. 


probableCause 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the PROBABLE_CAUSE of interface 
AttributeNameValue of module Alarm 1 RPConstDefs. 

Value of NV pair is a short defined by interface ProbableCause 
of module AlarmlRPConstDefs. 


perceivedSeverity 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the PERCEIVED_SEVERITY of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a short defined by interface 
PerceivedSeverity of module AlarmlRPConstDefs. 


rootCauselndicator 


One NV pair of 
filterable_body_fields 





Name of NV pair is the ROOT_CAUSE_INDICATOR of 
interface AttributeNameValue. 

Value of NV pair is a boolean defined by interface 
RootCauselndicator of module AlarmlRPConstDefs. 


correlatedNotifications 


One NV pair of 
remaining_body 





Name of NV pair is the CORRELATED_NOTIFICATIONS of 
interface AttributeNameValue. 

Value of NV pair is a CorrelatedNotificationSet of module 
AlarmlRPConstDefs. 


additionalText 


One NV pair of 
remaining_body 





Name of NV pair is the ADDITIONAL_TEXT of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a string. 


additionallnformation 


One or more NV 
pairs of 
remaining_body 





3GPP defines two Additional Information (Al) NV pairs for 

carrying vendor-specific (VS) perceived severity and alarm 

type. 

The names of these two NV pairs are: 

• Al VS PERCEIVED SEVERITY 

• AI_VS_ALARM_TYPE 

of interface Additionallnformation of module 

AlarmlRPConstDefs. 

The values of these two NV pairs are vendor defined. 

Other Al NV pairs are permitted to capture specific 

information. 

To be easily identified as vendor specific, the name value of 

these NV pairs should take the form of "ai_vs_<non-empty 

string>". 

The value of this NV pair is vendor defined. 


alarmld 


One NV pair of 
remaining_body 


M 


Name of NV pair is the ALARM_ID of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a string. 

If the string is a zero-length string or if this NV pair is absent, 
the default semantics is that alarmld is a concatenation of 
managedObjectlnstance, eventType, probableCause and 
specificProblem, if present, of this Structured Event. Since 
probableCause is encoded as a short, it shall be converted 
into string before concatenation. The resultant string shall not 
contain spaces. 
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IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


serviceUser 


One NV pair of 
remaining_body 


M 


Name of NV pair is the SERVICE_USER of interface 
AttributeNameValue of module Alarm IRPConstDefs. 

Value of NV pair is a string. 


serviceProvider 


One NV pair of 
remaining_body 


M 


Name of NV pair is the SERVICE_PROVIDER of interface 
AttributeNameValue of module Alarm IRPConstDefs. 

Value of NV pair is a string. 


secu rityAlarm Detector 


One NV pair of 
remaining_body 


M 


Name of NV pair is the SECURITY_ALARM_DETECTOR of 
interface AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a string. 



Table A.2.3.3: Mapping for notifyAckStateChanged 



IS Parameters 


OMG CORBA Structured 
Event attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
attribute. 


domain_name 




See that of notify NewAlarm. 


notificationType 


type_name 


M 


This is the NOTIFY_FM_ACK_STATE_CHANGED of 
interface NotificationType of module AlarmlRPConstDefs. 


alarmType 


event name 


M 


See that of notifyNewAlarm. 


There is no 
corresponding IS 
attribute. 


variable Header 






objectClass, 
objectlnstance 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


notificationid 


One NV pair of 
remaining body 


M 


See that of notifyNewAlarm. 


eventTime 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


systemDN 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


probableCause 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


perceivedSeverity 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


alarmld 


One NV pair of 
remaining body 


M 


See that of notifyNewAlarm. 


ackUserld 


One NV pair of 
remaining_body 


M 


Name of NV pair is the ACK_USER_ID of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a string. 


ackSystemId 


One NV pair of 
remaining_body 





Name of NV pair is the ACK_SYSTEM_ID of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a string. 


ackState 


One NV pair of 
remaining_body 


M 


Name of NV pair is the ACK_STATE of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a short defined by interface AckState of 
module AlarmlRPConstDefs. 
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Table A.2.3.4: Mapping for notifyClearedAlarm 



IS Parameters 


OMG CORBA Structured 
Event attribute 


Qualifier 


Comment 


There is no corresponding 
IS attribute. 


domain_name 




See that of notifyNewAlarm. 


notificationlype 


type_name 


M 


This is the NOTIFY_FM_CLEARED_ALARM of 
interface NotificationType of module 
AlarmlRPConstDefs. 


alarmlype 


event name 


M 


See that of notifyNewAlarm. 


There is no corresponding 
IS attribute. 


variable Header 






objectClass, 
objectlnstance 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


notificationid 


One NV pair of 
remaining body 


M 


See that of notifyNewAlarm. 


eventTime 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


systemDN 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


probableCause 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


perceivedSeverity 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


correlatedNotifications 


-- 


-- 


See Note. 


alarmld 


One NV pair of 
remaining body 


M 


See that of notifyNewAlarm. 


clearUserld 


One NV pair of 
remaining_body 





Name of NV pair is the CLEAR_USER_ID of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a string. 


clearSystemId 


One NV pair of 
remaining_body 





Name of NV pair is the CLEAR_SYSTEM_ID of 
interface AttributeNameValue of module 
AlarmlRPConstDefs. 

Value of NV pair is a string. 


NOTE: In the CORBA Solution Set the correlatedNotifications is not used. In the CORBA Solution Set, one 
notifyClearedAlarm notification can only clear a single alarmlnformation. 
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Table A.2.3.5: Mapping for notifyAlarmListRebuilt 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


Tliere is no corresponding IS 
attribute. 


domain_name 




See that of notify NewAlarm. 


notificationlype 


type_name 


M 


This is the NOTIFY_FM_ALARM_LIST_REBUILT of 
interface NotificationType of module 
AlarmlRPConstDefs. 


There is no corresponding IS 
attribute. 


event_name 


M 


Carry an empty string. 


There is no corresponding IS 
attribute. 


variable Header 






objectClass, objectlnstance 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


notificationid 


One NV pair of 
remaining body 


M 


See that of notifyNewAlarm. 


eventTime 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


systemDN 


One NV pair of 
filterable body fields 





See that of notifyNewAlarm. 


reason 


One NV pair of 
remaining_body 


M 


Name of NV pair is the REASON of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a string. 


alarm ListAlignmentRequirement 


One NV pair of 
remaining_body 





Name of NV pair is the 

ALARM_LIST_ALIGNMENT_REQUIREMENTof 
interface AttributeNameValue of module 
AlarmlRPConstDefs. 

Value of NV pair is an enum 
AlarmListAlignmentRequirement of module 
AlarmlRPConstDefs. 



Table A.2.3.6: Mapping for notifyChangedAlarm 



IS Parameters 


OMG CORBA Structured 
Event attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
attribute. 


domain_name 




See that of notifyNewAlarm. 


notificationType 


type_name 


M 


This is the NOTIFY_FM_CHANGED_ALARM of interface 
NotificationType of module AlarmlRPConstDefs. 


alarmType 


event name 


M 


See that of notifyNewAlarm. 


There is no 
corresponding IS 
attribute. 


variable Header 






objectClass, 
objectlnstance 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


notificationid 


One NV pair of 
remaining body 


M 


See that of notifyNewAlarm. 


eventTime 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


systemDN 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


probableCause 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


perceived Severity 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


alarmld 


One NV pair of 
remaining body 


M 


See that of notifyNewAlarm. 
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Table A.2.3.7: Mapping for notifycomments 



IS Parameters 


OMG CORBA Structured 
Event attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
attribute. 


domain_name 




See that of notifyNewAlarm. 


notificationType 


type_name 


M 


This is the NOTIFY_FM_COMMENT_ADDED of 
interface NotificationType of module 
AlarmlRPConstDefs. 


alarmType 


event name 


M 


See that of notifyNewAlarm. 


There is no 
corresponding IS 
attribute. 


variable Header 






objectClass, 
objectlnstance 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


notificationid 


One NV pair of 
remaining body 


M 


See that of notifyNewAlarm. 


eventTime 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


systemDN 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


probableCause 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


perceivedSeverity 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


alarmld 


One NV pair of 
remaining body 


M 


See that of notifyNewAlarm. 


comments 


One NV pair of 
remaining_body 


M 


Name of NV pair is the COIVIMENTS of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a CommentSet of module 
AlarmlRPConstDefs. 



Table A.2.3.8: Mapping for notifyPotentialFaultyAlarmList 



IS Parameters 


OIMG CORBA 

Structured Event 

attribute 


Qualifier 


uomment 


There is no 
corresponding IS 
attribute. 


domain_name 




See that of notifyNewAlarm. 


notificationType 


type_name 


M 


This is the NOTIFY_FM_POTENTIAL_FAULTY_ALARM_LIST of 
interface NotificationType of module AlarmlRPConstDefs. 


There is no 
corresponding IS 
attribute. 


event_name 


M 


It contains a NULL string. 


There is no 
corresponding IS 
attribute. 


variable Header 






objectClass, 
objectlnstance 


One NV pair of 
filterable_body_fields 


M 


See notifyNewAlarm. 

See sub-clause 'Definition' of this notification in [4] for the 
description of the usage of this field to indicate if part or all 
AlarmList is potentially faulty. 


notificationid 


One NV pair of 
remaining body 


M 




eventTime 


One NV pair of 
filterable body fields 


M 


See notifyNewAlarm. 


systemDN 


One NV pair of 
filterable body fields 


M 


See notifyNewAlarm. 


reason 


One NV pair of 
remainingbody 


M 


Name of NV pair is the REASON of interface AttributeNameValue 
of module AlarmlRPConstDefs. 

Value of NV pair is a string. 
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Table A.2.3.9: Mapping for notifyCorrelatedNotif icationChanged 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
attribute. 


domain_name 




See that of notifyNewAlarm. 


notificationType 


type_name 


M 


This is the 

NOTIFY_FM_CORRELATED_NOTIFICATION_CHANGEDof 
interface NotificationType of module AlarmlRPConstDefs. 


alarmType 


event name 


M 


See that of notifyNewAlarm. 


There is no 
corresponding IS 
attribute. 


variable Header 






objectClass, 
objectlnstance 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


notificationid 


One NV pair of 
remaining body 


M 


See that of notifyNewAlarm. 


eventTime 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


systemDN 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


correlatedNotifications 


One NV pair of 
remainingbody 





Name of NV pair is the CORRELATED_NOTIFICATIONS of 
interface AttributeNameValue. 

Value of NV pair is a CorrelatedNotificationSet of module 
AlarmlRPConstDefs. 


alarmld 


One NV pair of 
remaining body 


M 


See that of notifyNewAlarm. 


rootCauselndicator 


One NV pair of 
remaining body 





See that of notifyNewAlarm. 



A. 3 Solution Set definitions 
A.3.1 IDL definition structure 

Clause A. 3. 2 defines the constants and types used by the Alarm IRP. 

Clause A. 3. 3 defines the operations which are performed by the Alarm IRP agent. 

Clause A.3.4 defines the notifications which are emitted by the Alarm IRP agent. 

A.3.2 IDL specification "AlarmlRPConstDefs. idl" 

//File: AlarmlRPConstDef s . idl 

#ifndef _ALARM_IRP_CONST_DEFS_IDL_ 

#define _ALARM_IRP_CONST_DEFS_IDL_ 

#include <CosNotif ication. idl> 

#include <ManagedGenericIRPConstDef s . idl> 

// This statement must appear after all include statements 

#pragma prefix "3gppsa5.org" 

/* ## Module: AlarmlRPConstDefs 

This module contains commonly used definitions for Alarm IRP 

*/ 

module AlarmlRPConstDefs 

{ 

/* 

The format of Distinguished Name (DN) is specified in 3GPP TS 32.300 

"Name Conventions for Managed Objects". 

*/ 

typedef string DN; 

/* DNOpt is an optional type. 



£75/ 



3GPP TS 32.1 1 1 -6 version 1 0.4.0 Release 1 26 ETSI TS 1 32 1 1 1 -6 V1 0.4.0 (201 1 -1 0) 

If the discriminator is true the value is present. 

Otherwise the value is null. 

*/ 

union DNOpt switch (boolean) 

{ 

case TRUE: DN value; 

}; 
/* 

This block identifies the alarm types specified for this IRP version. 

These types carry the same semantics as the TMN ITU-T defined event 

types of the same name. 

Their encodings for this version of Alarm IRP are defined here. Other IRP 

documents, or other versions of Alarm IRP, shall identify their own 

alarm types for their use. They shall define their encodings 

as well. Values defined here are unique among themselves. 

*/ 

interface AlarmType 

{ 

const string COMMUNICATIONS_ALARM = "xl"; 

const string PROCESSING_ERROR_ALARM = "x2"; 

const string ENVIRONMENTAL_ALARM = "x3"; 

const string QUALITY_OF_SERVICE_ALARM = "x4"; 

const string EQUI PMENT_ALARM = "x5"; 

const string INTEGRITY_VIOLATION = "xS"; 

const string OPERATIONAL_VIOLATION = "x7"; 

const string PHYSICAL_VIOLATION = "xS"; 

const string SECURITY_SERVICE_OR_MECHANISM_VIOLATION = "x9",- 

const string TIME_DOMAIN_VIOLATION = "xlO"; 

}; 
/* 

This block identifies the notification types defined by this 

Alarm IRP version. 

*/ 

interface Notif icationType 

{ 

const string NOTIFY_FM_NEW_ALARM = "xl"; 

const string NOTIFY_FM_CHANGED_ALARM = "x2",- 

const string NOTIFY_FM_ACK_STATE_CHANGED = "x3"; 

const string NOTIFY_FM_COMMENT_ADDED = "X4"; 

const string NOTIFY_FM_CLEARED_ALARM = "x5"; 

const string NOTIFY_FM_ALARM_LIST_REBUILT = "x6"; 

const string NOTIFY_FM_POTENTIAL_FAULTY_ALARM_LIST = "x7"; 

const string NOTIFY_FM_CORRELATED_NOTIFICATION_CHANGED = "x8"; 

}; 
/* 

This block identifies the levels of severity. 

*/ 

interface PerceivedSeverity 

{ 

const short INDETERMINATE = 1 ; 
const short CRITICAL = 2 ; 
const short MAJOR = 3 ; 
const short MINOR = 4 ; 
const short WARNING = 5 ; 
const short CLEARED = 6 ; 

}; 
/* 

This block identifies the probable cause of a reported alarm. 

*/ 

interface ProbableCause 

{ 

/* 

Probable causes originating from M.3100. 

Values below correspond to M.3100 values. 

const short INDETERMINATE = ; 

const short ALARM_INDICATION_SIGNAL = 1 ; 

const short CALL_SETUP_FAILURE = 2 ; 

const short DEGRADED_SIGNAL = 3 ; 

const short FAR_END_RECEIVER_FAILURE = 4 ; 

const short FRAMING_ERROR = 5 ; 

const short LOSS_OF_FRAME = 6 ; 

const short LOSS_OF_POINTER = 7 ; 

const short LOSS_OF_SIGNAL = 8 ; 

const short PAYLOAD_TYPE_MISMATCH = 9 ; 

// Values 10 correspond to a duplicated probable cause 

const short REMOTE_ALARM_INTERFACE = 11; 

const short EXCESSIVE BIT ERROR RATE = 12; 
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const short PATH_TRACE_MISMATCH = 13; 

const short UNAVAILABLE = 14; 

const short SIGNAL_LABEL_MISMATCH = 15; 

const short LOSS_OF_MULTI_FRAME = 16; 

const short COMMUNICATIONS_RECEIVE_FAILURE = 17; 

const short COMMUNICATIONS_TRANSMIT_FAILURE = 18; 

const short MODULATION_FAILURE = 19; 

const short DEMODULATION_FAILURE = 20; 

// Values 21-26 correspond to duplicated probable causes 

// Values 27-50 are reserved for M.3100 potential future extensions 

const short BACK_PLANE_FAILURE = 51; 

const short DATA_SET_PROBLEM = 52; 

const short EQUIPMENT_IDENTIFIER_DUPLICATION = 53; 

const short EXTERNAL_IF_DEVICE_PROBLEM = 54; 

const short LINE_CARD_PROBLEM = 55; 

const short MULTIPLEXER_PROBLEM = 56; 

const short NE_IDENTIFIER_DUPLICATION = 57; 

const short POWER_PROBLEM = 58; 

const short PROCESSOR_PROBLEM = 59; 

const short PROTECTION_PATH_FAILURE = 60; 

const short RECEIVER_FAILURE = 61; 

const short REPLACEABLE_UNIT_MISSING = 62; 

const short REPLACEABLE_UNIT_TYPE_MISMATCH = 63; 

const short SYNCHRONIZATION_SOURCE_MISMATCH = 64; 

const short TERMINAL_PROBLEM = 65; 

const short TIMING_PROBLEM = 66; 

const short TRANSMITTER_FAILURE = 67; 

const short TRUNK_CARD_PROBLEM = 68; 

const short REPLACEABLE_UNIT_PROBLEM = 69; 

const short REAL_TIME_CLOCK_FAILURE = 70; 

// Values 71-80 correspond to duplicated probable causes 

const short PROTECTION_MECHANISM_FAILURE = 81; 

const short PROTECTING_RESOURCE_FAILURE = 82; 

// Values 83-100 are reserved for M.3100 potential future extensions 

const short AIR_COMPRESSOR_FAILURE = 101; 

const short AIR_CONDITIONING_FAILURE = 102; 

const short AIR_DRYER_FAILURE = 103; 

const short BATTERY_DISCHARGING = 104; 

const short BATTERY_FAILURE = 105; 

const short COMMERCIAL_POWER_FAILURE = 106; 

const short COOLING_FAN_FAILURE = 107; 

const short ENGINE_FAILURE = 108; 

const short FIRE_DETECTOR_FAILURE = 109; 

const short FUSE_FAILURE = 110; 

const short GENERATOR_FAILURE = 111; 

const short LOW_BATTERY_THRESHOLD = 112; 

const short PUMP_FAILURE = 113; 

const short RECTIFIER_FAILURE = 114; 

const short RECTIFIER_HIGH_VOLTAGE = 115; 

const short RECTIFIER_LOW_F_VOLTAGE = 116; 

const short VENTILATION_SYSTEM_FAILURE = 117; 

const short ENCLOSURE_DOOR_OPEN = 118; 

const short EXPLOSIVE_GAS = 119; 

const short FIRE = 12 0; 

const short FLOOD = 121; 

const short HIGH_HUMIDITY = 122; 

const short HIGH_TEMPERATURE = 123; 

const short HIGH_WIND = 124; 

const short ICE_BUILD_UP = 125; 

const short INTRUSION_DETECTION = 126; 

const short LOW_FUEL = 12 7; 

const short LOW_HUMIDITY = 128; 

const short LOW_CABLE_PRESSURE = 12 9; 

const short LOW_TEMPERATURE = 130; 

const short LOW_WATER = 131; 

const short SMOKE = 132; 

const short TOXIC_GAS = 133; 

// Values 134-135 correspond to duplicated probable causes 

const short EXTERNAL_POINT_FAILURE = 136; 

// Values 137-150 are reserved for potential M.3100 future extensions 

const short STORAGE_CAPACITY_PROBLEM = 151; 

const short MEMORY_MISMATCH = 152; 

const short CORRUPT_DATA = 153; 

const short OUT_OF_CPU_CYCLES = 154; 

const short SOFTWARE_ENVIRONMENT_PROBLEM = 155; 

const short SOFTWARE_DOWNLOAD_FAILURE = 156; 

const short LOSS_OF_REAL_TIME = 157; 

const short REINITIALIZED = 158; 
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// Values 159-167 correspond to duplicated probable causes 

// Values 168-200 are reserved for potential M.3100 future extensions 

// Values 201-202 correspond to duplicated probable causes 

const short EXCESSIVE_ERROR_RATE = 203; 

// Values 204-207 correspond to duplicated probable causes 

// Values 208-300 are reserved for potential M.3100 future extensions 

/* 

Probable causes originating from X.721. 

Values below correspond to X.721 values with an offset of 300. 

*/ 

const short ADAPTER_ERROR = 3 01; 

const short APPLICATION_SUBSYSTEM_FAILURE = 302; 

const short BANDWIDTH_REDUCED = 303; 

// Value 304 corresponds to a duplicated probable cause 

const short COMMUNICATIONS_PROTOCOL_ERROR = 305; 

const short COMMUNICATIONS_SUBSYSTEM_FAILURE = 306; 

const short CONFIGURATION_OR_CUSTOMIZATION_ERROR = 307; 

const short CONGESTION = 3 08; 

// Value 309 corresponds to a duplicated probable cause 

const short CPU_CYCLES_LIMIT_EXCEEDED = 310; 

const short DATA_SET_OR_MODEM_ERROR = 311; 

// Value 312 corresponds to a duplicated probable cause 

const short DTE_DCE_INTERFACE_ERROR = 313; 

// Value 314 corresponds to a duplicated probable cause 

const short EQUIPMENT_MALFUNCTION = 315; 

const short EXCESSIVE_VIBRATION = 316; 

const short FILE_ERROR = 317; 

// Values 318-320 correspond to duplicated probable causes 

const short HEATING_OR_VENTILATION_OR_COOLING_SYSTEM_PROBLEM = 321; 

const short HUMIDITY_UNACCEPTABLE = 322; 

const short INPUT_OUTPUT_DEVICE_ERROR = 323; 

const short INPUT_DEVICE_ERROR = 324; 

const short LAN_ERROR = 325; 

const short LEAK_DETECTED = 326; 

const short LOCAL_NODE_TRANSMISSION_ERROR = 327; 

// Values 328-329 correspond to duplicated probable causes 

const short MATERIAL_SUPPLY_EXHAUSTED = 330; 

// Value 331 corresponds to a duplicated probable cause 

const short OUT_OF_MEMORY = 332; 

const short OUTPUT_DEVICE_ERROR = 333; 

const short PERFORMANCE_DEGRADED = 334; 

// Value 335 corresponds to a duplicated probable cause 

const short PRESSURE_UNACCEPTABLE = 336; 

// Values 337-338 correspond to duplicated probable causes 

const short QUEUE_SIZE_EXCEEDED = 339; 

const short RECEIVE_FAILURE = 34 0; 

// Value 341 corresponds to a duplicated probable cause 

const short REMOTE_NODE_TRANSMISSION_ERROR = 342; 

const short RESOURCE_AT_OR_NEARING_CAPACITY = 343; 

const short RESPONSE_TIME_EXCESSIVE = 344; 

const short RETRANSMISSION_RATE_EXCESSIVE = 345; 

const short SOFTWARE_ERROR = 346; 

const short SOFTWARE_PROGRAM_ABNORMALLY_TERMINATED = 347; 

const short SOFTWARE_PROGRAM_ERROR = 348; 

// Value 349 corresponds to a duplicated probable cause 

const short TEMPERATURE_UNACCEPTABLE = 350; 

const short THRESHOLD_CROSSED = 351; 

// Value 352 corresponds to a duplicated probable cause 

const short TOXIC_LEAK_DETECTED = 353; 

const short TRANSMIT_FAILURE = 354; 

// Value 355 corresponds to a duplicated probable cause 

const short UNDERLYING_RESOURCE_UNAVAILABLE = 356; 

const short VERSION_MISMATCH = 357; 

// Values 358-500 are reserved for potential X.721 future extensions 

/* 

Probable causes for 2G & 3G wireless systems. 

const short A_BIS_TO_BTS_INTERFACE_FAILURE = 501; 

const short A_BIS_TO_TRX_INTERFACE_FAILURE = 502; 

const short ANTENNA_PROBLEM = 503; 

const short BATTERY_BREAKDOWN = 504; 

const short BATTERY_CHARGING_FAULT = 505; 

const short CLOCK_SYNCHRONIZATION_PROBLEM = 506; 

const short COMBINER_PROBLEM = 507; 

const short DISK_PROBLEM = 508; 

// Value 509 corresponds to a duplicated probable cause 

const short EXCESSIVE_RECEIVER_TEMPERATURE = 510; 

const short EXCESSIVE TRANSMITTER OUTPUT POWER = 511; 
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const short EXCESSIVE_TRANSMITTER_TEMPERATURE = 512; 

const short FREQUENCY_HOPPING_DEGRADED = 513; 

const short FREQUENCY_HOPPING_FAILURE = 514; 

const short FREQUENCY_REDEFINITION_FAILED = 515; 

const short LINE_INTERFACE_FAILURE = 516; 

const short LINK_FAILURE = 517; 

const short LOSS_OF_SYNCHRONIZATION = 518; 

const short LOST_REDUNDANCY = 519; 

const short MAINS_BREAKDOWN_WITH_BATTERY_BACKUP = 520; 

const short MAINS_BREAKDOWN_WITHOUT_BATTERY_BACKUP = 521; 

const short POWER_SUPPLY_FAILURE = 522; 

const short RECEIVER_ANTENNA_FAULT = 523; 

// Value 524 corresponds to a duplicated probable cause 

const short RECEIVER_MULTICOUPLER_FAILURE = 525; 

const short REDUCED_TRANSMITTER_OUTPUT_POWER = 526; 

const short SIGNAL_QUALITY_EVALUATION_FAULT = 527; 

const short TIMESLOT_HARDWARE_FAILURE = 528; 

const short TRANSCEIVER_PROBLEM = 52 9; 

const short TRANSCODER_PROBLEM = 530; 

const short TRANSCODER_OR_RATE_ADAPTER_PROBLEM = 531; 

const short TRANSMITTER_ANTENNA_FAILURE = 532; 

const short TRANSMITTER_ANTENNA_NOT_ADJUSTED = 533; 

// Value 534 corresponds to a duplicated probable cause 

const short TRANSMITTER_LOW_VOLTAGE_OR_CURRENT = 535; 

const short TRANSMITTER_OFF_FREQUENCY = 536; 

const short DATABASE_INCONSISTENCY = 537; 

const short FILE_SYSTEM_CALL_UNSUCCESSFUL = 538; 

const short INPUT_PARAMETER_OUT_OF_RANGE = 539; 

const short INVALID_PARAMETER = 540; 

const short INVALID_POINTER = 541; 

const short MESSAGE_NOT_EXPECTED = 542; 

const short MESSAGE_NOT_INITIALIZED = 543; 

const short MESSAGE_OUT_OF_SEQUENCE = 544; 

const short SYSTEM_CALL_UNSUCCESSFUL = 54 5; 

const short TIMEOUT_EXPIRED = 546; 

const short VARIABLE_OUT_OF_RANGE = 547; 

const short WATCH_DOG_TIMER_EXPIRED = 548; 

const short COOLING_SYSTEM_FAILURE = 549; 

const short EXTERNAL_EQUIPMENT_FAILURE = 550; 

const short EXTERNAL_POWER_SUPPLY_FAILURE = 551; 

const short EXTERNAL_TRANSMISSION_DEVICE_FAILURE = 552; 

// Values 553-560 correspond to duplicated probable causes 

const short REDUCED_ALARM_REPORTING = 561; 

const short REDUCED_EVENT_REPORTING = 562; 

const short RECUCED_LOGGING_CAPABILITY = 563; 

const short SYSTEM_RESOURCES_OVERLOAD = 564; 

const short BROADCAST_CHANNEL_FAILURE = 565; 

const short CONNECTION_ESTABLISHMENT_ERROR = 566; 

const short INVALID_MESSAGE_RECEIVED = 567; 

const short INVALID_MSU_RECEIVED = 568; 

const short LAPD_LINK_PROTOCOL_FAILURE = 569; 

const short LOCAL_ALARM_INDICATION = 570; 

const short REMOTE_ALARM_INDICATION = 571; 

const short ROUTING_FAILURE = 572; 

const short SS7_PR0T0C0L_FAILURE = 573; 

const short TRANSMISSION_ERROR = 574; 

// Value 575 corresponds to a duplicated probable cause 

// Values 576-700 are reserved for potential future extensions 

// for 2G & 3G wireless systems 

/* 

Probable causes originating from M.3100 security alarm causes. 

Values below correspond to M.3100 values with an offset of 700. 

*/ 

const short AUTHENTICATION_FAILURE = 701; 

const short BREACH_OF_CONFIDENTIALITY = 702; 

const short CABLE_TAMPER = 703; 

const short DELAYED_INFORMATION = 704; 

const short DENIAL_OF_SERVICE = 705; 

const short DUPLICATE_INFORMATION = 706; 

const short INFORMATION_MISSING = 707; 

const short INFORMATION_MODIFICATION_DETECTED = 708; 

const short INFORMATION_OUT_OF_SEQUENCE = 709; 

// Value 710 corresponds to a duplicated probable cause 

const short KEY_EXPIRED = 711; 

const short NON_REPUDIATION_FAILURE = 712; 

const short OUT_OF_HOURS_ACTIVITY = 713; 

const short OUT_OF_SERVICE = 714; 

const short PROCEDURAL ERROR = 715; 
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const short UNAUTHORISED_ACCESS_ATTEMPT = 716; 

const short UNEXPECTED_INFORMATION = 717; 

const short UNSPECIFIED_REASON = 718; 

// Values 719-800 are reserved for potential M.3100 future extensions 

}; 

/* 

It indicates that this Alarmlnformation is the root cause of the events captured by the 
notifications whose identifiers are in the related CorrelatedNotif ication instances. 
*/ 
typedef boolean RootCauselndicator; 

/* 

This block identifies the acknowledgement state of a reported alarm. 

*/ 

interface AckState 

{ 

const short ACKNOWLEDGED = 1; 
const short UNACKNOWLEDGED = 2; 

}; 
/* 

This block identifies attributes which are included as part of the Alarm IRP 

These attribute values should not clash with those defined for the attributes 

of notification header {see IDL of Notification IRP) . 

*/ 

interface AttributeNameValue 

{ 

const string ALARM_ID = "f"; 
const string PROBABLE_CAUSE = "g" ; 
const string PERCEIVED_SEVERITY = "h"; 
const string SPECIFIC_PROBLEM = "i"; 
const string ADDITIONAL_TEXT = "j"; 
const string ACK_TIME = "k" ; 
const string ACK_USER_ID = "1"; 
const string ACK_SYSTEM_ID = "m" ; 
const string ACK_STATE = "n" ; 
const string COMMENTS = "o"; 
const string BACKED_UP_STATUS = "p"; 
const string BACK_UP_OBJECT = "q" ; 
const string THRESHOLD_INFO = "r"; 
const string TREND_INDICATION = "s"; 
const string STATE_CHANGE_DEFINITION = "t"; 
const string MONITORED_ATTRIBUTES = "u" ; 
const string PROPOSED_REPAIR_ACTIONS = "v" ; 
const string CORRELATED_NOTIFICATIONS = "w" ; 
const string REASON = "x" ; 
const string CLEAR_USER_ID = "y" ; 
const string CLEAR_SYSTEM_ID = "z"; 

const string ALARM_LIST_ALIGNMENT_REQUIREMENT = "ff"; 
const string SERVICE_USER = "gg" ; 
const string SERVICE_PROVIDER = "hh" ; 
const string SECURITY_ALARM_DETECTOR = "ii"; 
const string ALARM_RAISED_TIME = "kk" ; 
const string ALARM_CLEARED_TIME = "11"; 
const string ALARM_CHANGED_TIME = "mm" ; 
const string ROOT_CAUSE_INDICATOR = "nn" ; 

}; 
/* 

constants for use in populating the additional information 

name field Names 
*/ 
interface Additionalinf ormation 

{ 

const string AI_VS_PERCEIVED_SEVERITY = "ai_ps"; 
const string AI_VS_ALARM_TYPE = "ai_at"; 

}; 
/* 

Defines the content of a Comment 

struct Comment 

{ 

ManagedGenericIRPConstDef s : : IRPTime comment_time; 
string comment_text ; 
string user_id; 
string system_id; 

}; 
/* 

Defines a set of comments which are placed in the COMMENTS attribute 
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of a structured event . 

*/ 

typedef sequence <Comment> CommentSet; 

/* 

It indicates if an object has a back up. 

True implies backed up. False implies not backed up. 

*/ 

typedef boolean BackedUpStatus; 

/* 

It indicates if the threshold crossed was in the up or down direction. 

*/ 

enum Thresholdlndication {UP, DOWN}; 

/* 

It indicates if the AlarmList alignment is required. 

*/ 

enum AlarmListAlignmentRequirement {REQUIRED, NOTREQUIRED} ; 

/* FloatOpt is an optional type. 

If the discriminator is true the value is present. 

Otherwise the value is null. 

*/ 

union FloatOpt switch (boolean) 

{ 

case TRUE: float value; 

}; 

/* ThresholdLevelInd describes multi-level 
threshold crossings. 

Up is the only permitted choice for a counter. 
If indication is "up", low value is optional, 
©member indication: indicates up or down direction 

of crossing, 
©member low: the low observed value, 
©member high: the high observed value. 
*/ 
struct ThresholdLevelInd 

{ 

Thresholdlndication indication; 
FloatOpt low; 
float high; 

}; 

/* ThresholdLevellndOpt is an optional type. 

If the discriminator is true the value is present. 

Otherwise, the value is null. 

*/ 

union ThresholdLevellndOpt switch (boolean) 

{ 

case TRUE: ThresholdLevelInd value; 

}; 

/* Thresholdlnfo indicates some gauge or counter 

attribute passed a set threshold. 

©member attribute_id: identifies the attribute that 

crossed the threshold, 
©member observed_value : attributes that are of type 

integer will be converted to floats, 
©member threshold_level : This parameter is for 

multi-level thresholds. Optional, 
©member arm_time: May contain empty string. 
*/ 
struct Thresholdlnfo 

{ 

string attribute_id; 
float observed_value; 

ThresholdLevellndOpt threshold_level ; 
string arm_time; 

}; 
/* 

It indicates if some observed condition is getting better, worse, 

or not changing. 

*/ 

enum Trendlndication {LESS_SEVERE, N0_CHANGE, M0RE_SEVERE} ; 

/* 

It is used to report a changed attribute value. 

*/ 

struct AttributeValueChange 

{ 

string attribute_name; 

any old_value; // type depends on attribute 

any new_value; // type depends on attribute 
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typedef sequence <AttributeValueChange> AttributeChangeSet ; 

/* 

It is used to report an attribute and its value. 

*/ 

struct AttributeValue 

{ 

string attribute_name; 

any value; // type depends on the attribute 

}; 

typedef sequence <AttributeValue> AttributeSet ; 

typedef sequence <long> NotifldSet; 

/* 

This holds identifiers of notifications that are correlated. 

*/ 

struct CorrelatedNotif ication 

{ 

DN source; // Contains DN of MO that emitted the set of notifications 
// DN string format in compliance with Name Convention for 
// Managed Object. 

// This may be a zero- length string. In this case, the MO 
// is identified by the value of the MOI attribute 
// of the Structured Event, i.e., the notification. 
NotifldSet notif_id_set ; // Set of related notification ids 

}; 
/* 

Correlated Notification sets are sets of Correlated Notification 

structures . 

V 

typedef sequence <CorrelatedNotif ication> CorrelatedNotif icationSet; 

/* 

Define the structure of Alarm ID and Perceived Severity used within the 

alarm acknowledgment operation. Note: perceived_severity is an optional 

parameter. If this value is present, it must have one of the defined values 

of Interface PerceivedSeverity . 

*/ 

struct Alarmlnf ormationldAndSev 

{ 

string alarm_id; 

ManagedGenericIRPConstDef s : : ShortOpt perceived_severity; 

}; 
/* 

Define set of the above structure of Alarm ID and Perceived Severity. 

*/ 

typedef sequence <AlarmInformationIdAndSev> Alarmlnf ormationldAndSevSeq; 

/* 

It indicates the reason for an alarm acknowledgement to have failed: 

- The specified Alarm Information is absent from the Alarm List 

- The Perceived Severity to be acknowledged has changed and/or is different 
within the Alarm List 

- The acknowledgement failed for some other reason 
*/ 

enum AcknowledgeFailureCategories 

{ 

UNKNOWN_ALARM_ID , 

WRONG_PERCEIVED_SEVERITY, 

ACKNOWLEDGMENT_FAILED 

}; 
/* 

Define the structure returned when an operation fails for a set of alarm ids. 

A reason is provided in order to indicate why the operation failed. 

*/ 

struct BadAlarmlnformationId 

{ 

string alarm_id; 
string reason; 

}; 

Define the structure returned when the acknowledge operation fails for a set 

of alarm ids. 

A failure category and a reason are provided in order to indicate why the 

operation failed. 

*/ 

struct BadAcknowledgeAlarmlnfo 

{ 

string alarm_id; 

AcknowledgeFailureCategories f ailure_category; 

string reason; 
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typedef sequence <BadAlarmInformationId> BadAlarmlnformationldSeq; 

typedef sequence <BadAcknowledgeAlarmInf o> BadAcknowledgeAlarmInf oSeq; 

typedef sequence <string> AlarmlnformationldSeq; 

typedef CosNotif ication: : EventBatch AlarmlnformationSeq; 

/* 

Define the cause values of notifyPotentialFaultyAlarmList and 

notifyAlarmListRebuilt , which have been defined in 32111-2. 

*/ 

const string AGENT_NE_COMMUNICATION_ERROR = "Agent-NE communication error"; 

const string AGENT_RESTARTS = "Agent restarts"; 

const string INDETERMINATE = "Indeterminate"; 

}; 

#endif // _ALARM_IRP_CONST_DEFS_IDL_ 

A.3.3 IDL specification 'AlarmlRPSystem.idr 

//File: AlarmlRPSystem. idl 
#ifndef _ALARM_IRP_SYSTEM_IDL_ 
#define _ALARM_IRP_SYSTEM_IDL_ 

#include <AlarmIRPConstDef s . idl> 
#include <ManagedGenericIRPSystem. idl> 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: AlarmlRPSystem 

This module contains the specification of all operations of Alarm IRP Agent. 



*/ 

module AlarmlRPSystem 

{ 

/* 

System fails to complete the operation. System can provide reason 

to qualify the exception. The semantics carried in reason 

is outside the scope of this IRP. 

*/ 

exception GetAlarmlRPVersions { string reason; }; 

exception GetAlarmlRPOperationsProf ile { string reason; }; 

exception GetAlarmlRPNotif icationProf ile { string reason; }; 

exception AcknowledgeAlarms { string reason; }; 

exception UnacknowledgeAlarms { string reason; }; 

exception CommentAlarms { string reason; }; 

exception ClearAlarms { string reason; }; 

exception GetAlarmList { string reason; }; 

exception GetAlarmCount { string reason; }; 

exception NextAlarmlnformations { string reason; }; 

exception FilterComplexityLimit { string reason; }; 

/* 

The Alarmlnformationlterator is used to iterate through a snapshot of 

Alarm Informations taken from the Alarm List when IRPManager invokes 

get_alarm_list . IRPManager uses it to pace the return of Alarm 

Informations . 

IRPAgent controls the life-cycle of the iterator. However, a destroy 

operation is provided to handle the case where IRPManager wants to stop 

the iteration procedure before reaching the last iteration. 

*/ 

interface Alarmlnformationlterator 

{ 

/* 

This method returns between 1 and "how_many" Alarm Informations. The 

IRPAgent may return less than "how_many" items even if there are more 

items to return. "how_many" must be non-zero. Return TRUE if there may 

be more Alarm Information to return. Return FALSE if there are no more 

Alarm Information to be returned. 

If FALSE is returned, the IRPAgent will automatically destroy the 

iterator. 

boolean next_alarm_informations { 

in unsigned short how_many, 

out AlarmlRPConstDef s : :AlarmInformationSeq alarm_informations 
) 
raises {NextAlarmlnformations, ManagedGenericIRPSystem: : InvalidParameter) 

/* 
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This method destroys the iterator. 

*/ 

void destroy {) ; 

}; 

interface AlarmlRP 

{ 

/* 

Return the list of all supported Alarm IRP versions. 

Implementations are to provide a return value consisting of one or more 

IRPVersions . 

Each IRPVersion is defined by the rule in the clause titled 

"IRP document version number string" 

*/ 

ManagedGenericIRPConstDef s : iVersionNumberSet get_alarm_irp_versions { 

) 

raises (GetAlarmlRPVersions) ; 

/* 

Return the list of all supported operations and their supported 

parameters for a specific Alarm IRP version. 

*/ 

ManagedGenericIRPConstDef s : iMethodList get_alarm_irp_operations_prof ile { 

in ManagedGenericIRPConstDef s : iVersionNumber alarm_irp_version 
) 
raises {GetAlarmlRPOperationsProf ile , 

ManagedGenericIRPSystem: lOperationNot Supported, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Return the list of all supported notifications and their supported 
parameters for a specific Alarm IRP version. 
*/ 

ManagedGenericIRPConstDef s : iMethodList get_alarm_irp_notif ication_prof ile 
{ 

in ManagedGenericIRPConstDef s : iVersionNumber alarm_irp_version 
) 
raises {GetAlarmlRPNotif icationProf ile , 

ManagedGenericIRPSystem: lOperationNot Supported, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Request to acknowledge one or more alarms. 

*/ 

ManagedGenericIRPConstDef s :: Signal acknowledge_alarms { 
in AlarmlRPConstDef s : : Alarmlnf ormationldAndSevSeq 

alarm_information_id_and_sev_list , 
in string ack_user_id, 

in ManagedGenericIRPConstDef s :: StringOpt ack_system_id, 
out AlarmlRPConstDef s : iBadAcknowledgeAlarmlnfoSeq 
bad_ack_alarm_info_list 
) 

raises {AcknowledgeAlarms, ManagedGenericIRPSystem: : ParameterNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Request to remove acknowledgement information of one or more alarms. 

*/ 

ManagedGenericIRPConstDef s :: Signal unacknowledge_alarms { 

in AlarmlRPConstDef s : : Alarmlnf ormationldSeq alarm_information_id_list , 

in string ack_user_id, 

in ManagedGenericIRPConstDef s :: StringOpt ack_system_id, 

out AlarmlRPConstDef s : :BadAlarmInf ormationldSeq 
bad_alarm_information_id_list 
) 
raises {UnacknowledgeAlarms, 



ManagedGenericIRPSystem : 
ManagedGenericIRPSystem: 
ManagedGenericIRPSystem: 



OperationNot Supported, 
ParameterNotSupported, 
InvalidParameter) ; 



/* 

Make comment to one or more alarms . 

*/ 

ManagedGenericIRPConstDef s :: Signal comment_alarms { 

in AlarmlRPConstDef s : : Alarmlnf ormationldSeq alarm_information_id_list , 

in string comment_user_id, 

in ManagedGenericIRPConstDef s :: StringOpt comment_system_id, 

in string comment_text , 
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out AlarmlRPConstDef s : : BadAlarmInf ormationldSeq 
bad_alarm_information_id_list 
) 

raises {CommentAlarms, ManagedGenericIRPSystem: lOperationNotSupported, 
ManagedGenericIRPSystem: : ParameterNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Request to clear one or more alarms. 

*/ 

ManagedGenericIRPConstDef s :: Signal clear_alarms { 

in AlarmlRPConstDef s : lAlarmInf ormationldSeq alarm_information_id_list , 
in string clear_user_id, 

in ManagedGenericIRPConstDef s :: StringOpt clear_system_id, 
out AlarmlRPConstDef s : : BadAlarmInf ormationldSeq 
bad_alarm_information_id_list 
) 

raises {ClearAlarms, ManagedGenericIRPSystem: lOperationNotSupported, 
ManagedGenericIRPSystem: : ParameterNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

This method returns Alarm Informations. 

If flag is TRUE, all returned Alarm Informations shall be 

in AlarmlnformationSeq that contains or more Alarm Informations. 

Output parameter iter shall be useless. 

If flag is FALSE, no Alarm Informations shall be in AlarmlnformationSeq. 

IRPAgent needs to use iter to retrieve them. 

*/ 

AlarmlRPConstDef s :: AlarmlnformationSeq get_alarm_list { 

in ManagedGenericIRPConstDef s :: StringOpt filter, 

in AlarmlRPConstDef s : :DNOpt base_object, 

out boolean flag, 

out Alarmlnformationlterator iter 
) 

raises {GetAlarmList , FilterComplexityLimit , ManagedGenericIRPSystem: : ParameterNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

This method returns the count of Alarm Informations. 

*/ 

void get_alarm_count { 

in ManagedGenericIRPConstDef s :: StringOpt filter, 

out unsigned long critical_count , 

out unsigned long majorcount, 

out unsigned long minorcount, 

out unsigned long warning_count , 

out unsigned long indeterminate_count , 

out unsigned long cleared_count 
) 

raises {GetAlarmCount , FilterComplexityLimit, ManagedGenericIRPSystem: :OperationNotSupported, 
ManagedGenericIRPSystem: : ParameterNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

}; 
}; 

#endif // _ALARM_IRP_SYSTEM_IDL_ 

A.3.4 IDL specification "AlarmlRPNotifications.icH" 

//File : AlarmlRPNotif ications . idl 
iifndef _ALARM_IRP_NOTIFICATIONS_IDL_ 
#define _ALARM_IRP_NOTIFICATIONS_IDL_ 

#include <AlarmIRPConstDef s . idl> 

#include <NotificationIRPNotif ications . idl> 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: AlarmlRPNotif ications 

This module contains notifications for Alarm IRP 
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module AlarmlRPNotif ications 
{ 

interface NotifyNewAlarm: NotificationlRPNotif ications : iNotify 

{ 

const string EVENT_TYPE = "notifyNewAlarm" ; 

/** 

* This constant defines the name of the probableCause property. 

* The data type for the value of this property 

* is short. 

const string PROBABLE_CAUSE = 

AlarmlRPConstDefs: : AttributeName Value : : PROBABLE_CAUSE; 

/** 

* This constant defines the name of the 

* perceivedSeverity property. 

* The data type for the value of this property 

* is short. 
*/ 

const string PERCEIVED_SEVERITY = 

AlarmlRPConstDefs: : AttributeName Value : : PERCEIVED SEVERITY; 



/** 

* This constant defines the name of the specif icProblem 

* property. The data type for the value of this property 

* is string. 
*/ 

const string SPECIFIC_PROBLEM = 

AlarmlRPConstDefs: : AttributeName Value : : SPECIFIC_PROBLEM; 

/** 

* The two constants defines the name of the additionalinf ormation 

* property {the vendor- specif ic (VS) perceived severity and alarm type) 

* The data type for the value of this property 

* is string. 
*/ 

const string AI_VS_PERCEIVED_SEVERITY = 

AlarmlRPConstDefs: : Additionalinf ormation: :AI_VS_PERCEIVED_SEVERITY; 
const string AI_VS_ALARM_TYPE = 

AlarmlRPConstDefs: : Additionalinf ormation : : AI_VS_ALARM_TYPE ; 

/** 

* This constant defines the name of the 

* rootCauselndicator property. 

* The data type for the value of this property 

* is AlarmlRPConstDef s : :RootCauseIndicator . 
*/ 

const string ROOT_CAUSE_INDICATOR = 

AlarmlRPConstDefs: : AttributeName Value : :ROOT_CAUSE_INDICATOR; 

/** 

* This constant defines the name of the 

* correlatedNotif ications property. 

* The data type for the value of this property 

* is AlarmlRPConstDef s :: CorrelatedNotif icationSet . 
*/ 

const string CORRELATED_NOTIFICATIONS = 
AlarmlRPConstDefs: : AttributeName Value : : 
CORRELATED_NOTIFICATIONS ; 

/** 

* This constant defines the name of the 

* backedUpStatus property. 

* The data type for the value of this property 

* is AlarmlRPConstDef s : :BackedUpStatus . 
*/ 

const string BACKED_UP_STATUS = 

AlarmlRPConstDefs: : AttributeName Value : : BACKED_UP_STATUS ; 

/** 

* This constant defines the name of the backUpObject property. 

* The data type for the value of this property 

* is a string carrying of DN of the back-up object. 
*/ 
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const string BACK_UP_OBJECT = 

AlarmlRPConstDefs: :AttributeName Value : : BACK_UP_OBJECT; 

/** 

* This constant defines the name of the 

* trendlndication property. 

* The data type for the value of this property 

* is AlarmlRPConstDef s : iTrendlndication. 
*/ 

const string TREND_INDICATION = 

AlarmlRPConstDefs: lAttributeName Value : :TREND_INDICATION; 

/** 

* This constant defines the name of the thresholdlnfo property. 

* The data type for the value of this property 

* is AlarmlRPConstDef s : iThresholdlnfo. 
*/ 

const string THRESHOLD_INFO = 

AlarmlRPConstDefs: lAttributeName Value : :THRESHOLD_INFO; 

/** 

* This constant defines the name of the 

* stateChangeDef inition property. 

* The data type for the value of this property 

* is AlarmlRPConstDef s : lAttributeChangeSet . 
*/ 

const string STATE_CHANGE_DEFINITION = 

AlarmlRPConstDefs : lAttributeName Value : : STATE_CHANGE_DEFINITION; 

/** 

* This constant defines the name of the 

* monitoredAttributes property. 

* The data type for the value of this property 

* is AlarmlRPConstDef s : lAttributeSet . 
*/ 

const string MONITORED_ATTRIBUTES = 

AlarmlRPConstDefs: lAttributeName Value : :MONITORED_ATTRIBUTES; 

/** 

* This constant defines the name of the 

* proposedRepairActions property. 

* The data type for the value of this property 

* is string. 
*/ 

const string PROPOSED_REPAIR_ACTIONS = 

AlarmlRPConstDefs: :AttributeName Value : : PROPOSED_REPAIR_ACTIONS ; 

/** 

* This constant defines the name of the additionalText 

* property. 

* The data type for the value of this property 

* is string. 
*/ 

const string ADDITIONAL_TEXT = 

AlarmlRPConstDefs: :AttributeName Value : : ADDITIONAL_TEXT; 

/** 

* This constant defines the name of the alarmld property. 

* The data type for the value of this property 

* is string. If the string is a zero-length string or if 

* this NV pair is absent, the default semantics is that 

* alarmld is a concatenation of 

* managedObjectlnstance, eventType, probableCause and 

* specif icProblem, if present, of this Structured Event. 

* Since probableCause is encoded as a short, it shall be 

* converted into string before concatenation. 

* The resultant string shall not contain spaces. 
*/ 

const string ALARM_ID = 

AlarmlRPConstDefs: :AttributeName Value : :ALARM_ID; 

/** 

* This constant defines the name of the serviceUser property. 

* The data type for the value of this property 

* is string. 
*/ 

const string SERVICE_USER = 

AlarmlRPConstDefs: :AttributeName Value : : SERVICE USER; 
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/** 

* This constant defines the name of the serviceProvider 

* property. 

* The data type for the value of this property 

* is string. 
*/ 

const string SERVICE_PROVIDER = 

AlarmlRPConstDefs: lAttributeName Value : : SERVICE_PROVIDER; 

/** 

* This constant defines the name of the 

* securityAlarmDetector property. 

* The data type for the value of this property 

* is string. 
*/ 

const string SECURITY_ALARM_DETECTOR = 

AlarmlRPConstDefs : :AttributeName Value : : SECURITY_ALARM_DETECTOR; 

}; 

interface NotifyAckStateChanged: 

Notif icationlRPNotif ications : iNotify 

{ 

const string EVENT_TYPE = "notifyAckStateChanged" ; 

const string PROBABLE_CAUSE = 

AlarmlRPConstDefs: lAttributeName Value : : PROBABLE_CAUSE ; 

const string PERCEIVED_SEVERITY = 

AlarmlRPConstDefs: lAttributeName Value : : PERCEIVED_SEVERITY; 

const string ALARM_ID = 

AlarmlRPConstDefs: : AttributeName Value : :ALARM_ID; 

/** 

* This constant defines the name of the ackTime property. 

* The data type for the value of this property 

* is ManagedGenericIRPConstDef s : : IRPTime. 
*/ 

const string ACK_TIME = 

AlarmlRPConstDefs: : AttributeName Value : : ACK_TIME; 

const string ACK_USER_ID = 

AlarmlRPConstDefs: : AttributeName Value : :ACK_USER_ID; 

const string ACK_SYSTEM_ID = 

AlarmlRPConstDefs: : AttributeName Value : :ACK_SYSTEM_ID; 

const string ACK_STATE = 

AlarmlRPConstDefs: : AttributeName Value : :ACK_STATE; 

}; 

interface Notif yClearedAlarm: Notif icationlRPNotif ications : :Notify 

{ 

const string EVENT_TYPE = "notifyClearedAlarm" ; 

const string PROBABLE_CAUSE = 

AlarmlRPConstDefs: : AttributeName Value : : PROBABLE_CAUSE; 

const string PERCEIVED_SEVERITY = 

AlarmlRPConstDefs: : AttributeName Value : : PERCEIVED_SEVERITY; 

const string ALARM_ID = 

AlarmlRPConstDefs: : AttributeName Value : :ALARM_ID; 

const string CLEAR_USER_ID = 

AlarmlRPConstDefs: : AttributeName Value : : CLEAR_USER_ID; 

const string CLEAR_SYSTEM_ID = 

AlarmlRPConstDefs: :AttributeName Value : :CLEAR SYSTEM ID; 



interface NotifyAlarmListRebuilt : 

Notif icationlRPNotif ications : :Notify 

{ 

const string EVENT_TYPE = "notifyAlarmListRebuilt " ; 

const string REASON = 
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AlarmlRPConstDef s : lAttributeName Value : : REASON; 

const string ALARM_LIST_ALIGNMENT_REQUIREMENT = 
AlarmlRPConstDef s : : AttributeName Value : : 
ALARM_L I ST_AL I GNMENT_REQUI REMENT ; 



interface NotifyChangedAlarm: Notif icationlRPNotif ications : iNotify 

{ 

const string EVENT_TYPE = "notifyChangedAlarm" ; 

const string PROBABLE_CAUSE = 

AlarmlRPConstDef s: : AttributeName Value : : PROBABLE_CAUSE ; 

const string PERCEIVED_SEVERITY = 

AlarmlRPConstDef s: : AttributeName Value : : PERCEIVED_SEVERITY; 

const string ALARM_ID = 

AlarmlRPConstDef s : : AttributeName Value : :ALARM_ID; 

}; 

interface NotifyComments : Notif icationlRPNotif ications : iNotify 

{ 

const string EVENT_TYPE = "notifyComments" ; 

const string PROBABLE_CAUSE = 

AlarmlRPConstDef s: : AttributeName Value : : PROBABLE_CAUSE ; 

const string PERCEIVED_SEVERITY = 

AlarmlRPConstDef s: : AttributeName Value : : PERCEIVED_SEVERITY; 

const string ALARM_ID = 

AlarmlRPConstDef s : : AttributeName Value : :ALARM_ID; 

/** 

* This constant defines the name of the comments property. 

* The data type for the value of this property 

* is AlarmlRPConstDef s : iCommentSet . 
*/ 

const string COMMENTS = 

AlarmlRPConstDef s: : AttributeName Value : : COMMENTS ; 



interface NotifyPotentialFaultyAlarmList : 
Notif icationlRPNotif ications : iNotify 

{ 

const string EVENT_TYPE = "notifyPotentialFaultyAlarmList " ; 

/** 

* This constant defines the name of the reason property. 

* The data type for the value of this property 

* is string. 
*/ 

const string REASON = 

AlarmlRPConstDef s : : AttributeName Value : iREASON; 

}; 

interface Notif yCorrelatedNotificationChanged : 
Notif icationlRPNotif ications : iNotify 

{ 

const string EVENT_TYPE = "notifyCorrelatedNotif icationChanged" ; 

const string CORRELATED_NOTIFICATIONS = 
AlarmlRPConstDef s : : AttributeName Value : : 
CORRELATED_NOTIFICATIONS ; 

const string ALARM_ID = 

AlarmlRPConstDef s : : AttributeName Value : :ALARM_ID; 

const string ROOT_CAUSE_INDICATOR = 

AlarmlRPConstDefs: lAttributeNameValue: :ROOT CAUSE INDICATOR; 



}; 



#endif // _ALARM_IRP_NOTIFICATIONS_IDL_ 
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Annex B (normative): 
XML Definitions 



This annex contains the XML Definitions for the Alarm Integration Reference Point (Alarm IRP) as it applies to Itf-N, 
in accordance with Alarm IRP IS definitions [4] as well as Notification Log IRP XML Definitions [13]. 

Apart from being used for the Notification Log, the XML definitions for Alarm IRP notifications are also used by the 
Alarm IRP SOAP SS. 



B.1 Architectural Features 

The overall architectural feature of Alarm IRP is specified in 3G TS 32.111-2 [4] . This clause specifies features that are 
specific to the XML definitions. 

B.1 .1 Syntax for Distinguished Names 

The syntax of a Distinguished Name is defined in 3GPP TS 32.300 [6]. 

B.1. 2 Notification Services 

This annex defines the XML syntax of Alarm IRP notifications that is to be used for the Alarm IRP SOAP Solution Set 
and in conjunction with Notification Log IRP XML Definitions for Notification Log IRP XML Data File and the NL 
IRP XML Notification Format [13]. 

B.1. 3 IOC Definitions 

This annex defines the XML syntax for the IOC definitions of the Alarm IRP IS [4], which are used by the XML 
definitions for the Alarm IRP notifications and the Alarm IRP IS operations. 



B.2 Mapping 

Not present in the current version of this specification. 



B.3 Solution Set definitions 
B.3.1 XML definition structure 

Clause B.3. 2 provides a graphical representation of the XML elements. 

Clause B.3. 3 provides XML definitions of Alarm IRP notifications as defined in [4]. These definitions are to be used for 
the Alarm IRP SOAP Solution Set and in conjunction with Notification Log IRP XML Definitions for Notification Log 
IRP XML Data File and the NL IRP XML Notification Format [13], as well as considerations for NL IRP XML File 
Name Conventions defined therein. 

Clause B.3. 4 provides XML definitions of Alarm IOC as defined in [4]. 



£75/ 



3GPP TS 32.111-6 version 10.4.0 Release 10 



41 



ETSI TS 132 111-6 VI 0.4.0 (2011-10) 



B.3.2 Graphical Representation 
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B.3.3 XML Schema 'alarmlRPNotif.xsd' 

<?xml version="l . 0" encoding="UTF-8" ?> 
< ! - - 

3GPP TS 32.111-6 Alarm IRP Notifications XML Schema 
alarmlRPNotif.xsd 
- - > 

< schema xmlns :xa="http : //www. 3gpp . org/ ftp/ specs/archive/ 32_series/ 32 . lll-6#alarmIRPNotif " 
xmlns :xai="http : //www. 3gpp . org/ ftp/ specs /archive/3 2_series/3 2 . lll-6#alarmIRPIOCs" 
xmlns :xe="http : //www. 3gpp . org/ ftp/ specs /archive/3 2_series/3 2 . 3 6#notif ication" 
xmlns :xn="http : //www. 3gpp . org/ ftp/ specs /archive/3 2_series/3 2 . 62 6#genericNrm" 
xmlns : sm="http : //www. 3gpp . org/ ftp/ specs /archive/3 2_series/3 2 . 6 76#stateManagementIRP" 
xmlns="http: //www.w3 . org/2 01/XMLSchema" 

targetNamespace="http : //www. 3gpp . org/ ftp/ specs/archive/ 32_series/ 32 . lll-6#alarmIRPNotif " 
elementFormDefault=" qualified" attributeFormDefault=" unqualified" > 

< import namespace="http : //www. 3gpp .org/f tp/specs/archive/32_series/32 . lll-6#alarmIRPI0Cs"/> 
< import namespace="http : //www. 3gpp .org/f tp/ specs /archive/ 3 2_series/3 2 . 3 6#not if ication" /> 
< import namespace="http : //www. 3gpp .org/f tp/ specs /archive/ 3 2_series/3 2 . 62 6#genericNrm"/> 
< import namespace="http : //www. 3gpp .org/f tp/specs/archive/32_series/32 . 676#stateManagementIRP"/> 
<simpleType name="AlarmListAlignmentRequirement" > 
<restriction base="string" > 

<enumeration value= "Alignment Required"/> 
<enumeration value= "Alignment Not Required"/> 
< /restrict ion> 
</simpleType> 

<simpleType name="AlarmListRebuiltReason" > 
<restriction base="string" > 

<enumeration value="Agent NE Communications Error"/> 
<enumeration value= "Agent Restarts" /> 
< enumeration value=" Indeterminate" /> 
</restriction> 
</simpleType> 

<complexType name="Reason" > 
<choice> 

< element name= "predefined" type="xa :AlarmListRebuiltReason"/> 
<element name="otherValue" type="string"/> 
</choice> 
</complexType> 

<element name=" reason" type="xa : Reason" /> 
<complexType name="NotifyAckStateChanged" > 
<complexContent> 

<extension base="xe iNotif ication" > 
<sequence> 

<element name="body"> 
<complexType> 
<sequence> 

< element ref ="xai :probableCause"/> 
<element ref ="xai :perceivedSeverity"/> 
<element ref ="xai :alarmType"/> 
<element ref ="xai : alarmId"/> 
<element ref ="xai :ackState"/> 
<element ref ="xai : ackUserId"/> 

<element ref ="xai : ackSystemId" minOccurs=" 0"/> 
</sequence> 
</complexType> 
</element> 
</sequence> 
</extension> 
</complexContent> 
</complexType> 

<complexType name="NotifyAlarmListRebuilt" > 
<complexContent> 

<extension base="xe iNotif ication" > 
<sequence> 

<element name="body"> 
< c omp 1 exTyp e > 
<sequence> 

<element ref = "xa : reason" /> 

<element name="alarmListAlignmentRequirement" 
type="xa : AlarmListAlignmentRequirement" minOccurs="0"/> 

</sequence> 
</complexType> 
</element> 
</sequence> 
</extension> 
< /complexContent > 
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</complexType> 

<complexType name="NotifyChangedAlarm" > 
<complexContent> 

<extension base="xe iNotif ication" 
<sequence> 

<element name="body"> 

< c omp 1 exTyp e > 

<sequence> 

<element ref= 
<element ref= 
<element ref= 
<element ref= 
</sequence> 
</complexType> 
</element> 
</sequence> 
</extension> 
</complexContent> 
</complexType> 

<complexType name="NotifyClearedAlarm" > 
<complexContent> 

<extension base="xe iNotif ication" 
<sequence> 

<element name="body"> 
<complexType> 
<sequence> 

<element ref= 
<element ref= 
<element ref= 
<element ref= 
<element ref= 
<element ref= 
<element ref= 
</sequence> 
</complexType> 
</element> 
</sequence> 
</extension> 
</complexContent> 
</complexType> 

<complexType name="NotifyComments" > 
<complexContent> 

<extension base="xe iNotif ication" 
<sequence> 

<element name="body"> 
<complexType> 
<sequence> 

<element ref= 
<element ref= 
<element ref= 
<element ref= 
<element ref= 
</sequence> 
</complexType> 
</element> 
</sequence> 
</extension> 
< / comp lexContent> 
</complexType> 

<complexType name="NotifyNewAlarm" > 
<complexContent> 

<extension base="xe iNotif ication" 
<sequence> 

<element name="body"> 

< c omp 1 exTyp e > 

<sequence> 

<element ref= 
<element ref= 
<element ref= 
<element ref= 
<element ref= 
<element ref= 
<element ref= 
< element name 
<element ref= 
<element ref= 
<element ref= 
<element ref= 



"xai :probableCause"/> 
"xai :perceivedSeverity"/> 
"xai : alarmType"/> 
"xai : alarmld" /> 



"xai :probableCause"/> 

"xai :perceivedSeverity"/> 

"xai : alarmType"/> 

"xai : alarmld" /> 

"xai : correlatedNotif ications" minOccurs=" 0"/> 

"xai : clearUserld" minOccurs="0"/> 

"xai : clearSystemId" minOccurs="0"/> 



"xai : alarmType"/> 
"xai :probableCause"/> 
"xai : perceivedSeverity " / > 
"xai : comments" /> 
"xai : alarmld" /> 



"xai :probableCause"/> 

"xai : perceivedSeverity" /> 

"xai : alarmType"/> 

"xai : alarmld" /> 

"xai : specif icProblem" minOccurs=" 0"/> 

"xai : correlatedNotif ications" minOccurs="0"/> 

"xai ibackedUpStatus" minOccurs="0"/> 

="backupObject" type="xn:dn" minOccurs="0"/> 

"xai : trendlndication" minOccurs=" 0"/> 

"xai : thresholdlnfo" minOccurs="0"/> 

"xai : stateChangeDef inition" minOccurs=" 0"/> 

"xai : monitoredAttributes " minOccurs= " " / > 
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<element ref ="xai iproposedRepairActions" minOccurs="0"/> 
<element ref ="xai : additionalText" minOccurs="0"/> 
<element ref ="xai : additionallnformation" minOccurs=" 0"/> 
</sequence> 
</complexType> 
</element> 
</sequence> 
</extension> 
</complexContent> 
</complexType> 
<complexType name="NotifyNewSecurityAlarm" > 

< c omp lexContent> 

<extension base="xe iNotif ication" > 
<sequence> 

<element name="body"> 
<complexType> 
<sequence> 

< element ref ="xai :probableCause"/> 
< element ref ="xai :perceivedSeverity"/> 
<element ref ="xai : alarmType"/> 
< element ref ="xai : serviceUser"/> 
< element ref ="xai : serviceProvider"/> 
< element ref ="xai : securityAlarmDetector"/> 
<element ref ="xai : alarmId"/> 

<element ref ="xai : correlatedNotif ications" minOccurs="0"/> 
<element ref ="xai : additionalText" minOccurs="0"/> 
<element ref ="xai : additionallnformation" minOccurs=" 0"/> 
</sequence> 
</complexType> 
</element> 
</sequence> 
</extension> 
</complexContent> 
</complexType> 
<complexType name="NotifyPotentialFaultyAlarmList" > 

< comp lexContent> 

<extension base="xe iNotif ication" > 
<sequence> 

<element name="body"> 
< c omp 1 exTyp e > 
<sequence> 

<element ref ="xa : reason" /> 
</sequence> 
</complexType> 
</element> 
</sequence> 
</extension> 
< /complexContent > 
</complexType> 

<!-- Notification definitions --> 
<complexType name="NotifyCorrelatedNotif icationChanged" > 

< c omp lexContent> 

<extension base="xe iNotif ication" > 
<sequence> 

<element name="body"> 
<complexType> 
<sequence> 

< element ref ="xai : correlatedNotif ications" /> 
<element ref ="xai : alarmId"/> 
< element ref ="xai : rootCauseIndicator"/> 
</sequence> 
</complexType> 
</element> 
</sequence> 
</extension> 
< /complexContent > 
</complexType> 

< element name="NotifyAckStateChanged" type="xa :NotifyAckStateChanged"/> 
< element name="NotifyAlarmListRebuilt" type="xa :NotifyAlarmListRebuilt"/> 
< element name="NotifyChangedAlarm" type="xa :NotifyChangedAlarm"/> 
< element name="NotifyClearedAlarm" type="xa :NotifyClearedAlarm"/> 
<element name="NotifyComments" type="xa :NotifyComments"/> 
<element name="NotifyNewAlarm" type="xa :NotifyNewAlarm"/> 

<element name="NotifyNewSecurityAlarm" type="xa :NotifyNewSecurityAlarm"/> 

<element name="NotifyPotentialFaultyAlarmList" type="xa :NotifyPotentialFaultyAlarmList"/> 
<element name="NotifyCorrelatedNotif icationChanged" 
type="xa : Not if yCorrelatedNot if icationChanged" /> 
</schema> 



£75/ 



3GPP TS 32.1 1 1 -6 version 1 0.4.0 Release 1 49 ETSI TS 1 32 1 1 1 -6 V1 0.4.0 (201 1 -1 0) 



B.3.4 XML Schema 'alarmlRPIOCs.xsd' 

<?xml version="l . 0" encoding="UTF-8" ?> 
< ! - - 

3GPP TS 32.111-6 Alarm IRP IOC XML Schema 
alarmlRPIOCs .xsd 
- - > 

< schema xmlns :xai="http : //www. 3gpp .org/f tp/specs/archive/32_series/32 . lll-6#alarmIRPIOCs" 
xmlns :xe="http : //www. 3gpp . org/f tp/ specs /archive/3 2_series/3 2 . 30 6#notif ication" 
xmlns :xn="http : //www. 3gpp . org/f tp/ specs /archive/3 2_series/3 2 . 62 6#genericNrm" 
xmlns : sm="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 6 76#stateManagementIRP" 
xmlns="http: //www.w3 . org/2 01/XMLSchema" 

targe tNamespace="http : //www. 3gpp .org/f tp/specs/archive/32_series/ 32 . lll-6#alarmIRPIOCs" 
elementFormDefault= "qualified" attributeFormDefault=" unqualified" > 

< import namespace="http : //www. 3gpp .org/f tp/ specs /archive/ 3 2_series/3 2 . 3 6#not if ication" /> 

< import namespace="http : //www. 3gpp .org/f tp/ specs /archive/ 3 2_series/3 2 . 62 6#genericNrm"/> 

< import name space ="http : //www. 3gpp .org/f tp/ specs/archive/ 32_series/ 32 . 676#stateManagementIRP"/> 

<!-- Type definitions --> 

<simpleType name="AckState" > 

<restriction base="string" > 

< enumerat ion value = " Acknowledged " / > 
<enumeration value= "Unacknowledged" /> 
</restriction> 
</simpleType> 

<complexType name="CorrelatedNotif ication" > 
<sequence> 

<element name="source" type="xn:dn"/> 
<element name="notif icationldSet" > 
<complexType> 
<sequence> 

<element name="notif icationid" type="xe iNotif icationid" minOccurs="0" 
maxOccurs= " unbounded" / > 

</sequence> 
</complexType> 
</element> 
</sequence> 
</complexType> 

<complexType name="CorrelatedNotif icationSet" > 
<sequence> 

<element ref="xai : correlatedNotif ication" minOccurs="0" maxOccurs= "unbounded" /> 
</sequence> 
</complexType> 

<simpleType name="EventType" > 
<restriction base="string" > 

<enumeration value=" Communications Alarm"/> 
<enumeration value="Processing Error Alarm"/> 
<enumeration value=" Environmental Alarm"/> 
<enumeration value="Quality Of Service Alarm"/> 
<enumeration value=" Equipment Alarm" /> 
<enumeration value=" Integrity Violation" /> 
<enumeration value="Operational Violation"/> 
<enumeration value="Physical Violation"/> 

<enumeration value=" Security Service Or Mechanism Violation"/> 
<enumeration value="Time Domain Violation"/> 
</restriction> 
</simpleType> 

<simpleType name="PerceivedSeverity" > 
<restriction base="string" > 

< enumerat ion value="Critical"/> 
<enumeration value="Major"/> 
<enumeration value="Minor"/> 
<enumeration value="Warning"/> 
< enumerat ion value=" Indeterminate "/> 
<enumeration value=" Cleared" /> 
< /restrict ion> 
</simpleType> 

<simpleType name="ProbableCause" > 
<restriction base="string" > 

<enumeration value=" Indeterminate" /> 
<enumeration value="Alarm Indication Signal"/> 
<enumeration value="Call Setup Failure" /> 
<enumeration value=" Degraded Signal"/> 
<enumeration value="Far End Receiver Failure"/> 
<enumeration value=" Framing Error" /> 
<enumeration value="Loss Of Frame"/> 
<enumeration value="Loss Of Pointer"/> 
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"Loss Of Signal"/> 

"Payload Type Mismatch" /> 

"Transmission Error" /> 

"Remote Alarm Interface"/> 

"Excessive Bit Error Rate"/> 

"Path Trace Mismatch" /> 

"Unavailable" /> 

"Signal Label Mismatch" /> 

"Loss Of Multi Frame"/> 

"Communications Receive Failure"/> 

"Communications Transmit Failure"/> 

"Modulation Failure" /> 

"Demodulation Failure" /> 

"Back Plane Failure"/> 

"Data Set Problem"/> 

"Equipment Identifier Duplication" /> 

"External Device Problem" /> 

"Line Card Problem" /> 

"Multiplexer Problem" /> 

"NE Identifier Duplication"/> 

"Power Problem" /> 

"Processor Problem" /> 

"Protection Path Failure"/> 

"Receiver Failure"/> 

"Replaceable Unit Missing"/> 

"Replaceable Unit Type Mismatch" /> 

"Synchronization Source Mismatch"/> 

"Terminal Problem" /> 

"Timing Problem" /> 

"Transmitter Failure"/> 

"Trunk Card Problem" /> 

"Replaceable Unit Problem"/> 

"Real Time Clock Failure"/> 

"Protection Mechanism Failure"/> 

"Protecting Resource Failure" /> 

"Air Compressor Failure" /> 

"Air Conditioning Failure"/> 

"Air Dryer Failure" /> 

"Battery Discharging"/> 

"Battery Failure"/> 

"Commercial Power Failure"/> 

"Cooling Fan Failure"/> 

"Engine Failure"/> 

"Fire Detector Failure"/> 

"Fuse Failure"/> 

"Generator Failure" /> 

"Low Battery Threshold" /> 

"Pump Failure"/> 

"Rectifier Failure"/> 

"Rectifier High Voltage"/> 

"Rectifier Low F Voltage"/> 

"Ventilation System Failure" /> 

"Enclosure Door Open"/> 

"Explosive Gas"/> 

"Fire"/> 

" Flood" /> 

"High Humidity" /> 

"High Temperature" /> 

"High Wind"/> 

"Ice Build Up"/> 

"Intrusion Detection" /> 

"Low Fuel"/> 

"Low Humidity" /> 

"Low Cable Pressure"/> 

"Low Temperature" /> 

"Low Water"/> 

" Smoke " / > 

"Toxic Gas"/> 

"External Point Failure"/> 

"Storage Capacity Problem"/> 

"Memory Mismatch" /> 

"Corrupt Data"/> 

"Out Of CPU Cycles" /> 

"Software Environment Problem" /> 

"Software Download Failure"/> 

"Loss Of Real Time"/> 

"Reinitialized" /> 

"Excessive Error Rate"/> 
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< enumeration 


value=" 


<enumeration 


value=" 


<enumeration 


value=" 


<enumeration 


value=" 


<enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


<enumeration 


value=" 


<enumeration 


value=" 


<enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


<enumeration 


value=" 


< enumeration 


value=" 


<enumeration 


value=" 


<enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


<enumeration 


value=" 
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value=" 
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value=" 
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value=" 
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value=" 
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value=" 
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value=" 
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value=" 
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value=" 
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value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 
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value=" 


< enumeration 


value=" 
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value=" 


<enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


<enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


<enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


< enumeration 


value=" 


<enumeration 


value=" 


< enumeration 


value=" 



Adapter Error"/> 

Application Subsystem Failure"/> 

Bandwidth Reduced" /> 

Communications Protocol Error" /> 

Communications Subsystem Failure" /> 

Configuration Or Customizing Error" /> 

Congestion" /> 

CPU Cycles Limit Exceeded" /> 

Data Set Or Modem Error"/> 

DTE DCE Interface Error"/> 

Equipment Malfunction" /> 

Excessive Vibration" /> 

File Error" /> 

Heating Or Ventilation Or Cooling System Problem" /> 

Humidity Unacceptable" /> 

Input Output Device Error" /> 

Input Device Error" /> 

LAN Error" /> 

Leak Detected" /> 

Local Node Transmission Error" /> 

Material Supply Exhausted" /> 

Out Of Memory" /> 

Output Device Error" /> 

Performance Degraded" /> 

Pressure Unacceptable"/> 

Queue Size Exceeded" /> 

Receive Failure" /> 

Remote Node Transmission Error" /> 

Resource At Or Nearing Capacity" /> 

Response Time Excessive" /> 

Retransmission Rate Excessive"/> 

Software Error" /> 

Software Program Abnormally Terminated" /> 

Software Program Error" /> 

Temperature Unacceptable "/> 

Threshold Crossed" /> 

Toxic Leak Detected" /> 

Transmit Failure" /> 

Underlying Resource Unavailable" /> 

Version Mismatch" /> 

A BIS To BTS Interface Failure" /> 

A BIS To TRX Interface Failure" /> 

Antenna Problem" /> 

Battery Breakdown" /> 

Battery Charging Fault "/> 

Clock Synchronization Problem" /> 

Combiner Problem" /> 

Disk Problem" /> 

Excessive Receiver Temperature" /> 

Excessive Transmitter Output Power" /> 

Excessive Transmitter Temperature "/> 

Frequency Hopping Degraded" /> 

Frequency Hopping Failure" /> 

Frequency Redefinition Failed" /> 

Line Interface Failure"/> 

Link Failure"/> 

Loss Of Synchronization" /> 

Lost Redundancy" /> 

Mains Breakdown With Battery Backup" /> 

Mains Breakdown Without Battery Backup" /> 

Power Supply Failure" /> 

Receiver Antenna Fault "/> 

Receiver Multicoupler Failure" /> 

Reduced Transmitter Output Power" /> 

Signal Quality Evaluation Fault "/> 

Timeslot Hardware Failure"/> 

Transceiver Problem" /> 

Transcoder Problem" /> 

Transcoder Or Rate Adapter Problem" /> 

Transmitter Antenna Failure" /> 

Transmitter Antenna Not Adjusted"/> 

Transmitter Low Voltage Or Current "/> 

Transmitter Off Frequency" /> 

Database Inconsistency" /> 

File System Call Unsuccessful"/> 

Input Parameter Out Of Range" /> 

Invalid Parameter" /> 

Invalid Pointer"/> 
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"Message Not Expected" /> 

"Message Not Initialised"/> 

"Message Out Of Sequence"/> 

"System Call Unsuccessful"/> 

"Timeout Expired" /> 

"Variable Out Of Range"/> 

"Watch Dog Timer Expired" /> 

"Cooling System Failure"/> 

"External Equipment Failure"/> 

"External Power Supply Failure"/> 

"External Transmission Device Failure"/> 

"Reduced Alarm Reporting" /> 

"Reduced Event Reporting"/> 

"Recuced Logging Capability"/> 

"System Resources Overload" /> 

"Broadcast Channel Failure"/> 

"Call Establishment Error" /> 

"Invalid Message Received" /> 

"Invalid MSU Received" /> 

"LAPD Link Protocol Failure" /> 

"Local Alarm Indication" /> 

"Remote Alarm Indication" /> 

"Routing Failure"/> 

"SS7 Protocol Failure"/> 

"Authentication Failure" /> 

"Breach Of Confidentiality" /> 

"Cable Tamper"/> 

"Delayed Information" /> 

"Denial Of Service" /> 

"Duplicate Information"/> 

"Information Missing" /> 

"Information Modification Detected"/> 

"Information Out Of Sequence"/> 

"Key Expired" /> 

"Non Repudiation Failure" /> 

"Out Of Hours Activity" /> 

"Out Of Service" /> 

"Procedural Error"/> 

"Unauthorised Access Attempt"/> 

"Unexpected Information" /> 

"Unspecified Reason"/> 



<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 

<enumeration value 
</restriction> 
</simpleType> 

<simpleType name="ThresholdIndicator" > 
<restriction base="string" > 

<enumeration value="Up"/> 

<enumeration value="Down"/> 
</restriction> 
</simpleType> 

<simpleType name="TrendIndicator" > 
<restriction base="string" > 

<enumeration value="Less Severe"/> 

<enumeration value="No Change" /> 

<enumeration value="More Severe"/> 
</restriction> 
</simpleType> 

<simpleType name="AttributeType" > 
<restriction base="string" > 

<enumeration value="string"/> 

<enumeration value="integer"/> 

< enumeration value="unsignedInt"/> 

<enumeration value="boolean"/> 

< enumeration value="dateTime"/> 

< enumeration value = "base 6 4Binary"/> 
</restriction> 
</simpleType> 

<complexType name="AttributeValue" > 
<sequence> 

<element name="attributeName" type="string"/> 

<element name="attributeValue" type="anySimpleType"/> 

<element name="attributeType" type="xai : AttributeType" minOccurs=" 0"/> 
</sequence> 
</complexType> 

<complexType name="AttributeValueSet" > 
<sequence> 

<element name="attribueValue" type="xai : AttributeValue" minOccurs="0" 
maxOccur s = " unbounded " / > 
</sequence> 
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</complexType> 

<complexType name="AttributeValueChange" > 
<sequence> 

<element name="attributeName" type=" string" /> 
<element name="oldValue" type="anySimpleType"/> 
<element name="newValue" type="anySimpleType"/> 
</sequence> 
</complexType> 

<complexType name="AttributeValueChangeSet" > 
<sequence> 

<element name="attributeValueChange" type="xai : AttributeValueChange" minOccurs="0" 
maxOccur s = " unbounded " / > 
</sequence> 
</complexType> 

<complexType name="StateValueChange" > 
<sequence> 

< element name="attributeName" type="xai : StateAttributeNames"/> 
<element name="oldValue" type="xai : StateAttributeType" minOccurs=" 0"/> 
<element name="newValue" type="xai : StateAttributeType"/> 
</sequence> 
</complexType> 

<simpleType name="StateAttributeNames" > 
<restriction base="string" > 

<enumeration value= "Operational State" /> 
<enumeration value="Usage State"/> 
<enumeration value= "Administrative State"/> 
<enumeration value= "Alarm Status" /> 
<enumeration value=" Procedural Status" /> 
<enumeration value="Availability Status"/> 
<enumeration value=" Control Status"/> 
<enumeration value=" Standby Status" /> 
<enumeration value= "Unknown Status" /> 
< /restrict ion> 
</simpleType> 

<complexType name=" StateAttributeType" > 
<choice> 

< element name="operationalState" type="sm: operationalStateType"/> 
<element name="usageState" type="sm:usageStateType"/> 

< element name="administrativeState" type="sm: administrativeStateType"/> 
<element name="alarmStatus" type="sm: alarmStatusType"/> 
< element name= "proceduralStatus " type= " sm : proceduralStatusType " / > 
< element name="availabilityStatus" type="sm: availabilityStatusType"/> 
<element name="controlStatus" type="sm: controlStatusType"/> 
<element name="standbyStatus" type="sm: standbyStatusType"/> 
<element name="unknownStatus" type="sm:unknownStatusType"/> 
</choice> 
</complexType> 

<complexType name="StateValueChangeSet" > 
<sequence> 

<element name="stateValueChange" type="xai : StateValueChange" minOccurs="0" 
maxOccur s = " unbounded " / > 
</sequence> 
</complexType> 

<complexType name= " Comment " > 
<sequence> 

< element ref ="xai : commentTime"/> 
<element ref ="xai : commentText"/> 
<element ref ="xai : commentUserId"/> 

<element ref ="xai : commentSystemId" minOccurs=" 0"/> 
</sequence> 
</complexType> 

<complexType name="CommentSet" > 
<sequence> 

<element name=" comment" type="xai : Comment" minOccurs=" 0"/> 
</sequence> 
</complexType> 

<simpleType name="Notif icationType" > 
<restriction base="string" > 

< enumeration value="notifyNewAlarm"/> 
< enumeration value="notifyChangedAlarm"/> 
< enumeration value =" not if yClearedAlarm"/> 
</restriction> 
</simpleType> 

<complexType name="Notif icationldSet" > 
<sequence> 

<element name="notif icationid" type="xe iNotif icationid" minOccurs="0" 
maxOccur s = " unbounded " / > 
</sequence> 
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</complexType> 

<complexType name="ThresholdInf o" > 
<sequence> 

<element name="attributeld" type="string"/> 

<element name="observedValue" type="f loat"/> 

<element name="thresholdLevel" type="xai iThresholdLevel" minOccurs="0"/> 

<element name="armTime" type="dateTime"/> 
</sequence> 
</complexType> 

<complexType name="ThresholdLevel" > 
<sequence> 

<element name=" indication" type="xai :ThresholdIndicator"/> 

<element name="low" type="float" minOccurs=" 0"/> 

<element name="high" type="f loat"/> 
</sequence> 
</complexType> 

<!-- Attributes of the Alarmlnformation IOC --> 
<element name 
<element name 
<element name 
<element name 
<element name 
<element name 
<element name 
<element name 
<element name 
<element name 
<element name 
<element name 
<element name 
<element name 
<element name 
<element name 
< element name 
<element name 
<element name 
<element name 
<element name 
<element name 
<element name 
<element name 
<element name 
<element name 
<element name 



"alarmld" type="string"/> 

"alarmRaisedTime" type="dateTime"/> 

"alarmClearedTime" type="dateTime"/> 

" alarmChangedTime " type= " dateTime " / > 

"eventType" type="xai :EventType"/> 

"alarmType" subs ti tut ionGroup="xai : eventType" /> 

"probableCause" type="xai : ProbableCause"/> 

"perceivedSeverity" type="xai : PerceivedSeverity"/> 

"specif icProblem" type=" string" /> 

"backedUpStatus" type= "boolean" /> 

"trendlndication" type="xai :TrendIndicator"/> 

"thresholdinf o" type="xai :ThresholdInfo"/> 

"stateChangeDef inition" type="xai : StateValueChangeSet"/> 

"monitoredAt tributes " type= "xai : AttributeValueSet " / > 

"proposedRepairActions" type=" string" /> 

"additionalText" type=" string" /> 

"additional Information" type="xai :AttributeValueSet"/> 

"ackTime" type= "dateTime" /> 

"ackUserld" type="string"/> 

"ackSystemId" type="string"/> 

"ackState" type="xai :AckState"/> 

"clearUserld" type=" string" /> 

"clearSystemId" type=" string" /> 

"serviceUser" type=" string" /> 

"serviceProvider" type=" string" /> 

" securityAlarmDetector " type= " string" /> 

"rootCauselndicator" type= "boolean" /> 
<!-- AlarmList entity for alarms not related to security --> 
<complexType name="NonSecurityAlarm" > 
<sequence> 

<element name="notif icationType" type="xai iNotif icationType"/> 

<element ref= "xai : alarmType" /> 

< element ref ="xai :objectClass"/> 

< element ref = "xai :objectInstance"/> 

<element name="notif icationid" type="xe iNotif icationid" minOccurs="0' 

<element name="eventTime" type="dateTime" minOccurs=" 0"/> 



/> 



<element ref= 

<element ref= 

<element ref= 

<element ref= 

<element ref= 

<element ref= 

<element ref= 

<element ref= 

<element ref= 

<element ref= 

<element ref= 

<element ref= 

<element ref= 

<element ref= 

<element ref= 

<element ref= 

<element ref= 

<element ref= 

<element ref= 

<element ref= 

<element ref= 

<element ref= 

<element ref= 

<element name 

<element ref= 



xmsystemDN" minOccurs="0"/> 

xai : alarmld" /> 

xai : alarmRaisedTime" /> 

xai : alarmClearedTime" /> 

xai : alarmChangedTime" minOccurs="0"/> 

xai :probableCause"/> 

xai :perceivedSeverity"/> 

xai : rootCauselndicator" minOccurs=" 0"/> 

xai : specif icProblem" minOccurs=" 0"/> 

xai : backedUpStatus " minOccurs= " " / > 

xai : trendlndication" minOccurs=" 0"/> 

xai : thresholdinf o" minOccurs="0"/> 

xai : StateChangeDef inition" minOccurs="0"/> 

xai imonitoredAttributes" minOccurs="0"/> 

xai : proposedRepairActions" minOccurs=" 0"/> 

xai : additionalText" minOccurs=" 0"/> 

xai : additionallnformation" minOccurs=" 0"/> 

xai : ackTime " / > 

xai : ackUserId"/> 

xai : ackSystemId" minOccurs="0"/> 

xai : ackState" /> 

xai : clearUserld" minOccurs="0"/> 

xai : ClearSystemId" minOccurs="0"/> 

"backUpObject" type="xn:dn" minOccurs=" 0"/> 

xai : correlatedNotif ications" minOccurs=" 0"/; 
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<element ref ="xai : comments"/> 
</sequence> 
</complexType> 

<!-- AlarmList entity for alarms related to security --> 
<complexType name="SecurityAlarm" > 
<sequence> 

<element name="notif icationType" type="xai iNotif icationType"/> 

<element ref ="xai : alarmType"/> 

< element ref ="xai :objectClass"/> 

< element ref ="xai :objectInstance"/> 

<element name="notif icationid" type="xe iNotif icationid" minOccurs="0"/> 

<element name="eventTime" type="dateTime" minOccurs= ' ' /> 

<element ref ="xn: systemDN" minOccurs=" 0"/> 

<element ref ="xai : alarmId"/> 

< element ref ="xai :alarmRaisedTime"/> 

< element ref ="xai : alarmClearedTime"/> 

<element ref ="xai : alarmChangedTime" minOccurs="0"/> 

<element ref ="xai :probableCause"/> 

< element ref ="xai :perceivedSeverity"/> 

<element ref ="xai : rootCauselndicator" minOccurs=" 0"/> 

<element ref ="xai : specif icProblem" minOccurs=" 0"/> 

<element ref ="xai : additionalText" minOccurs="0"/> 

<element ref ="xai : additionallnformation" minOccurs="0"/> 

<element ref ="xai : ackTime"/> 

<element ref ="xai : ackUserId"/> 

<element ref ="xai : ackSystemId" minOccurs=" 0"/> 

<element ref ="xai : ackState"/> 

<element ref ="xai : clearUserld" minOccurs=" 0"/> 

<element ref ="xai : clearSystemId" minOccurs="0"/> 

<element ref ="xai : correlatedNotif ications" minOccurs="0"/> 

<element ref ="xai : comments"/> 

< element ref ="xai : serviceUser"/> 

< element ref ="xai : serviceProvider"/> 

"xai : securityAlarmDetector"/> 



<element ref=" 
</sequence> 
</complexType> 

<!-- Attributes of the Comment IOC --> 
<element name="commentTime" type="dateTime"/> 
<element name="commentText" type=" string" /> 
<element name="commentUserId" type=" string" /> 
<element name="commentSystemId" type=" string" /> 
<!-- A list of comment IOC instances --> 
<element name=" comments" type="xai : CommentSet"/> 
<!-- Attributes of the CorrelatedNotif ication IOC --> 
<element name="source" type="xn:dn"/> 

< element name="notif icationldSet" type="xai iNotif icationIdSet"/> 
<!-- A correlatedNotif ication IOC instance --> 

<element name=" correlatedNotif ication" type="xai : CorrelatedNotif ication" /> 
<!-- A set of correlatedNotif ication IOC instance --> 

< element name=" correlatedNotif ications" type="xai : CorrelatedNotif icationSet"/> 
<!-- MonitoredEntity IOC attributes; inherits from Top in order to obtain NRM IOC properties 
<element name="objectClass" type="string"/> 
<element name="objectInstance" type="xn:dn"/> 
</ schema > 
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Annex C (normative): 
SOAP Solution Set 



This annex specifies the SOAP Solution Set for the IRP whose semantics are specified in Alarm IRP: Information 
Service (3GPP TS 32.111-2 [4]). 



C.1 Architectural features 

The overall architectural feature of the Alarm IRP is specified in 3GPP TS 32.111-2 [4] . This clause specifies features 
that are specific to the SOAP solution set. 

C.1 .1 Syntax for Distinguished Names 

The syntax of a Distinguished Name is defined in 3GPP TS 32.300 [6]. 

C.1. 2 Notification Services 

The Alarm IRP SOAP SS uses the Notification IRP SOAP SS of 3GPP TS 32.306 [8]. The IRP Agent shall support the 
push interface model, which means that the IRP Agent sends alarm notifications to the IRPManager as soon as new 
events occur. The IRPManager does not need to check ("pull") for events. 

Relevant definitions are imported from the Alarm IRP XML definitions in Annex B. 

C.1 .3 Supported W3C specifications 

The SOAP 1.1 specification [16] and WSDL 1.1 specification [18] are supported. 

The SOAP 1.2 specification [17] is supported optionally. 

This specification uses "document" style in WSDL file. 

This specification uses "literal" encoding style in WSDL file. 

The filter language used in the SS is the XPath Language (see W3C XPath 1.0 specification [19]). IRP Agents may 
throw a FilterComplexityLimit fault when a given filter is too complex. 

C.1 .4 Prefixes and namespaces 

This specification uses a number of namespace prefixes throughout that are listed in Table C.1.4. 
Table C.1.4: Prefixes and Namespaces used in this specification 



PREFIX 


NAMESPACE 


(no prefix) 


http;//schemas.xmlsoap.org/wsdl/ 


soap 


http://schemas.xmlsoap.org/wsdl/soap/ 


alarmlRPSystem 


http://www.3gpp.org/ftp/specs/archive/32 series/32.1 11-6#AlarmlRPSystem 


alarmlRPData 


http://www.3gpp.org/ftp/specs/archive/32 series/32.1 11-6#AlarmlRPData 


xai 


http://www.3gpp.org/ftp/specs/archive/32 series/32.1 11-6#alarmlRPIOCs 


xn 


http://www.3gpp.org/ftp/specs/archive/32 series/32. 626#genericNrm 


genericlRPSystem 


http://www.3gpp.org/ftp/specs/archive/32 series/32.31 6#GenericlRPSystem 


ntflRPNtfSystem 


http://www.3gpp.org/ftp/specs/archive/32 series/32. 306#NotificationlRPNtfSystem 
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C.2 Mapping 

C.2.1 Operation and notification mapping 

The Alarm IRP IS (3GPP TS 32. 1 1 1 -2 [4]) defines the operations and their semantics. 

Table C.2.1 maps the operations defined in the Alarm IRP IS to their equivalent types, messages, port type operation, 
and binding operation in this Solution Set (SS). 

Table C.2.1 also maps the notifications of the Alarm IRP IS, as well as inherited operations. 

Table C.2.1 also qualifies if an operation is Mandatory (M) or Optional (O). 

Table C.2.1 : Mapping from IS Operation to SS Equivalents 



IS Operation in 3GPP TS 32.111-2 [4] 


SS: Operation of WSDL port 
type and WSDL binding 


SS: Port of 
AlarmlRPService 


Qualifier 


acknowledgeAlarms 


acknowledgeAlarms (note 1) 


AlarmlRPPort 


M 


getAlarmList 


getAlarmList (note 1) 


AlarmlRPPort 


M 


getAlarmCount 


getAlarmCount (note 1) 


AlarmlRPPort 





unacknowledgeAlarms 


unacknowledgeAlarms (note 1) 


AlarmlRPPort 





setComment 


setComment (note 1) 


AlarmlRPPort 





clearAlarms 


clearAlarms (note 1) 


AlarmlRPPort 





notifyNewAlarm 


notify (note 2) 


Notification IRPNtf Port 


M 


notifyAckStateChanged 


notify (note 2) 


NotificationlRPNtfPort 


M 


notifyClearedAlarm 


notify (note 2) 


Notification IRPNtf Port 


M 


notifyAlarmListRebuilt 


notify (note 2) 


NotificationlRPNtfPort 


M 


notifyChangedAlarm 


notify (note 2) 


NotificationlRPNtfPort 





notifyComments 


notify (note 2) 


NotificationlRPNtfPort 





notifyPotentialFaultyAlarmList 


notify (note 2) 


NotificationlRPNtfPort 





getlRPVersion (note 3) 


See TS 32.316 [11] 


GenericlRPPort 


M 


getOperationProfile (note 3) 


See TS 32.316 [11] 


GenericlRPPort 





getNotificationProfile (note 3) 


See TS 32.316 [11] 


GenericlRPPort 





NOTE 1 : The operation is under the port type alarmlRPSystem:AlarmlRPPortType and under the binding 
alarmlRPSystem:AlarmlRPBinding. 


NOTE 2: The IS equivalent maps to an XIVIL definition specified in Annex B, and this being an input parameter to 
the operation notify under the port type ntflRPNtfSystem:NotificationlRPNtf and under the binding 
ntflRPNtfSystem:NotificationlRPNtf of 3GPP TS 32.306 [8]. This binding is linked to a port of the 
AlarmlRPService as indicated in the table above. 


NOTE 3: The IS operation is inherited from the ManagedGenericIRP IOC specified in 3GPP TS 32.312 [10]. 
This inheritance is by the AlarmlRP IOC of 3GPP TS 32.1 11-2 [4] inheriting from the 
IVIanagedGenericIRP IOC. The corresponding binding is linked to a port of the AlarmlRPService as 
indicated in the table above. 



C.2.2 Operation parameter mapping 



The AlarmlRP IS (3GPP TS 32.111-2 [4]) defines semantics of parameters carried in the operations. The tables below 
show the mapping of these parameters, as per operation, to their equivalents defined in this SS. 
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C.2.2.1 Operation acknowledgeAlarms 

C.2.2.1 .1 Input parameters 

Table C.2.2.1.1 : Mapping from IS acknowledgeAlarms input parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding input message 

under corresponding port type operation 

as indicated in Table C.2.1 


Qualifier 


alarmlnformationAndSeverityReferenceList 


alarmlnformationAndSeverityReferenceList 


M 


ackUserld 


ackUserld 


M 


ackSystemId 


ackSystemId 






C.2.2.1 .2 Output parameters 

Table C.2.2.1. 2: Mapping from IS acknowledgeAlarms output parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding output message 

under corresponding port type operation 

as indicated in Table C.2.1 


Qualifier 


badAlarmlnformationReferenceList 


badAlarmlnformationReferenceList 


M 


status 


status 


M 



C.2.2.1. 3 Fault definition 

Table C.2.2.1. 3: Mapping from IS acknowledgeAlarms exceptions to SS equivalents 



Assertion name 


SS WSDL type enumeration value 

used in corresponding fault message 

under corresponding port type operation 

as indicated in Table C.2.1 


Qualifier 


operation failed 


OperationFailed 


M 



C.2.2.2 Operation getAlarmList 

C. 2. 2. 2.1 Input parameters 

Table C.2.2.2. 1 : Mapping from IS getAlarmList input parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding input message 

under corresponding port type operation 

as indicated in Table C.2.1 


Qualifier 


alarmAckState 


alarmAckState 





baseObjectClass 


baseObjectClass 





baseObjectlnstance 


baseObjectlnstance 





filter 


filter 
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C.2.2.2.2 Output parameters 

Table C.2.2.2.2: Mapping from IS getAlarmList output parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding output message 

under corresponding port type operation 

as indicated in Table C.2.1 


Qualifier 


alarmlnformationList 


alarmlnformationList 


M 


status 


status 


M 



C.2.2.2.3 Fault definition 

Table C.2.2.2.3: Mapping from IS getAlarmList exceptions to SS equivalents 



Assertion name 


SS WSDL type enumeration value 

used in corresponding fault message 

under corresponding port type operation 

as indicated in Table C.2.1 


Qualifier 


operation failed 


OperationFailed 


M 


filter complexity limit 


FilterComplexityLimit 


M 



C.2.2.3 Operation getAlarmCount 

C. 2. 2. 3.1 Input parameters 

Table C.2.2.3. 1 : Mapping from IS getAlarmCount input parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding input message 

under corresponding port type operation 

as indicated in Table C.2.1 


Qualifier 


filter 


filter 





alarmAckState 


alarmAckState 






C.2.2.3.2 Output parameters 

Table C.2.2.3.2: Mapping from IS getAlarmCount output parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding output message 

under corresponding port type operation 

as indicated in Table C.2.1 


Qualifier 


criticalCount 


criticalCount 


M 


majorCount 


majorCount 


M 


minorCount 


minorCount 


M 


warningCount 


warningCount 


M 


indeterminateCount 


indeterminateCount 


M 


clearedCount 


clearedCount 


M 


status 


status 


M 
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C.2.2.3.3 



Fault definition 



Table C.2.2.3.3: Mapping from IS getAlarmCount exceptions to SS equivalents 



Assertion name 


SS WSDL type enumeration value 

used in corresponding fault message 

under corresponding port type operation 

as indicated in Table C.2.1 


Qualifier 


operation failed 


OperationFailed 


M 


filter complexity limit 


FilterComplexityLimit 


M 



C.2.2.4 Operation unacknowledge Alarms 

C. 2. 2.4.1 Input parameters 

Table C.2.2.4.1 : Mapping from IS unacknowledgeAlarms input parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding input message 

under corresponding port type operation 

as indicated in Table C.2.1 


Qualifier 


alarmlnformationReferenceList 


alarmlnformationReferenceList 


M 


ackUserld 


ackUserld 


M 


ackSystemId 


ackSystemId 






C.2.2.4.2 Output parameters 

Table C.2.2.4.2: Mapping from IS unacknowledgeAlarms output parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding output message 

under corresponding port type operation 

as indicated in Table C.2.1 


Qualifier 


badAlarmlnformationReferenceList 


badAlarmlnformationReferenceList 


M 


status 


status 


M 



C.2.2.4.3 Fault definition 

Table C.2.2.4.3: Mapping from IS unacknowledgeAlarms exceptions to SS equivalents 



Assertion name 


SS WSDL type enumeration value 

used in corresponding fault message 

under corresponding port type operation 

as indicated in Table C.2.1 


Qualifier 


operation failed 


OperationFailed 


M 
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C.2.2.5 Operation setComment 

C. 2. 2. 5.1 Input parameters 

Table C.2.2.5. 1 : Mapping from IS setcomment input parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding input message 

under corresponding port type operation 

as indicated in Table C.2.1 


Qualifier 


alarmlnformationReferenceList 


alarmlnformationReferenceList 


M 


commentUserld 


commentUserld 


M 


commentSystemId 


commentSystemId 





commentText 


commentText 


M 



C.2.2.5. 2 Output parameters 

Table C.2.2.5.2: Mapping from IS setcomment output parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding output message 

under corresponding port type operation 

as indicated in Table C.2.1 


Qualifier 


badAlarmlnformationReferenceList 


badAlarmlnformationReferenceList 


M 


status 


status 


M 



C.2.2.5.3 Fault definition 

Table C.2.2.5.3: Mapping from IS setcomment exceptions to SS equivalents 



Assertion name 


SS WSDL type enumeration value 

used in corresponding fault message 

under corresponding port type operation 

as indicated in Table C.2.1 


Qualifier 


operationjailed 


OperationFailed 


M 



C.2.2.6 Operation clearAlarms 

C. 2. 2. 6.1 Input parameters 

Table C.2.2.6.1 : Mapping from IS clearAlarms input parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding input message 

under corresponding port type operation 

as indicated in Table C.2.1 


Qualifier 


alarmlnformationReferenceList 


alarmlnformationReferenceList 


M 


clearUserld 


clearUserld 


M 


clearSystemId 


ClearSystemId 
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C.2.2.6.2 Output parameters 

Table C.2.2.6.2: Mapping from IS clearAlarms output parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding output message 

under corresponding port type operation 

as indicated in Table C.2.1 


Qualifier 


badAlarmlnformationReferenceList 


badAlarmlnformationReferenceList 


M 


status 


status 


M 



C.2.2.6.3 Fault definition 

Table C.2.2.6.3: Mapping from IS clearAlarms exceptions to SS equivalents 



Assertion name 


SS WSDL type enumeration value 

used in corresponding fault message 

under corresponding port type operation 

as indicated in Table C.2.1 


Qualifier 


operation failed 


OperationFailed 


M 
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C.3 Solution Set definitions 
C.3.1 WSDL definition structure 

Clause C.3. 2 provides a graphical representation of the Alarm IRP service. 
Clause C.3. 3 defines the services which are supported the Alarm IRP agent. 

C.3.2 Graphical Representation 

The WSDL structure is depicted in Figure C.3.2 below, depicting port type, binding and service. The port type contains 
port type operations, which again contains input, output and fault messages. The binding contains binding operations, 
which have the same name as the port type operations. The binding connects to a port inside the service. 



Port Types 



Bindings 



Services 



AlarmlRPPortlype 



acknowledgeAlarms 

getAlarmList 

getAlarm Count 

unacknowledgeAlarms 

setComment 

clearAlarms 



AlarmlRPBinding 



acknowledgeAlarms 

getAlarmList 

getAlarmCount 

unacknowledgeAlarms 

setComment 

clearAlarms 



GenericlRPBinding 
(from 32.316) 



NotificationlRPNtf 
(from 32.306) 



AlarmlRPService 



AlarmlRPPort 



GenericlRPPort 



NotificationlRPNtfPort 



Figure C.3.2: Alarm IRP SOAP Solution Set WSDL structure 
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C.3.3 WSDL specification 'AlarmlRPSystem.wsdr 

<?xml version="l . 0" encoding="UTF-8" ?> 
< ! - - 

3GPP TS 32.111-6 Alarm IRP SOAP Solution Set 
- - > 

<def initions xmlns="http : //schemas .xmlsoap .org/wsdl/" 
xmlns : soap="http : //schemas .xmlsoap .org/wsdl /soap/" 

xmlns : alarmIRPSystem="http : //www. 3gpp . org/ ftp/ specs/archive/ 32_series/ 32 . lll-6#AlarmIRPSystem" 
xmlns : alarmIRPData="http : //www. 3gpp .org/f tp/ specs /archive/3 2_series/3 2 . lll-6#AlarmIRPData" 
xmlns :xai="http : //www. 3gpp .org/f tp/ specs /archive/ 3 2_series/3 2 . lll-6#alarmIRPIOCs" 
xmlns :xn="http : //www. 3gpp .org/f tp/specs/archive/32_series/32 . 62 6#genericNrm" 

xmlns :genericIRPSystem="http : //www. 3gpp .org/f tp/specs/archive/32_series/ 32 . 316#GenericIRPSystem" 
xmlns :ntf IRPNtf System="http : //www. 3gpp .org/f tp/specs/archive/32_series/ 32 . 3 6#Notif icationlRPNtf Syst 
em" targetNamespace="http : //www. 3gpp .org/f tp/specs/archive/32_series/32 . lll-6#AlarmIRPSystem" > 

< import 
namespace="http : //www. 3gpp .org/f tp/ specs /archive/3 2_series/3 2 . 3 6#Notif icationlRPNtf System" /> 

< import namespace="http : //www. 3gpp .org/f tp/ specs /archive/ 3 2_series/3 2 . 316#GenericIRPSystem"/> 
<types> 

< schema targetNamespace="http : //www. 3gpp .org/f tp/ specs/archive/ 32_series/ 32 .111- 
6#AlarmIRPData" xmlns="http: //www.w3 . org/2 1/XMLSchema " > 

< import namespace="http : //www. 3gpp .org/f tp/ specs/archive/ 32_series/ 32 .111- 
6#alarmIRPI0Cs"/> 

< import namespace="http : //www. 3gpp.org/ftp/specs/archive/32_series/32 . 62 6#genericNrm"/> 
<!-- The following types are defined for the Alarm IRP operations --> 
<simpleType name="AlarmAckState" > 
<restriction base="string" > 

<enumeration value="AllAlarms"/> 
<enumeration value="AllActiveAlarms"/> 
< enumeration value="AllActiveAndAcknowledgedAlarms"/> 
<enumeration value="AllActiveAndUnacknowledgedAlarms"/> 
<enumeration value="AllClearedAndUnacknowledgedAlarms"/> 
<enumeration value="AllUnacknowledgedAlarms"/> 
</restriction> 
</simpleType> 

<complexType name="AlarmIdAndSeverityElement" > 
<sequence> 

<element ref ="xai : alarmId"/> 

<element ref ="xai iperceivedSeverity" minOccurs="0"/> 
</sequence> 
</complexType> 
<complexType name="AlarmIdAndSeverityList" > 

<sequence minOccurs="l" maxOccurs="unbounded" > 

< element name="listElement" type="alarmIRPData : AlarmIdAndSeverityElement"/> 
</sequence> 
</complexType> 
<complexType name="AlarmIdList" > 

<sequence minOccurs="l" maxOccurs= "unbounded" > 

<element ref ="xai : alarmId"/> 
</sequence> 
</complexType> 
<complexType name="AlarmInformationList" > 

<choice minOccurs="0" maxOccurs="unbounded" > 

< element name="nonSecurityAlarm" type="xai :NonSecurityAlarm"/> 
<element name="securityAlarm" type="xai : SecurityAlarm"/> 
</choice> 
</complexType> 

<complexType name="BadAcknowledgeAlarmInfoRef Element" > 
<sequence> 

<element ref ="xai : alarmId"/> 

<element name="f ailureReason" type="alarmIRPData : FailureReasonBadAck"/> 
<element name="additionalFailureReason" type=" string" /> 
</sequence> 
</complexType> 

<complexType name="BadAcknowledgeAlarmInfoRefList" > 
<sequence minOccurs="0" maxOccurs= " unbounded" > 
<element name="listElement" 
type = " alarmlRPData : BadAcknowledgeAlarmlnfoRef Element " / > 
</sequence> 
</complexType> 

<complexType name="BadClearAlarmInfoRef Element" > 
<sequence> 

<element ref ="xai : alarmId"/> 

<element name="f ailureReason" type=" string" /> 
</sequence> 
</complexType> 
<complexType name="BadClearAlarmInfoRefList"> 

<sequence minOccurs=" 0" maxOccurs="unbounded" > 

<element name="listElement" type=" alarmlRPData iBadClearAlarmlnfoRef Element "/> 
</sequence> 
</complexType> 

<complexType name="BadCommentAlarmInfoRef Element" > 
<sequence> 

<element ref ="xai : alarmId"/> 

<element name="f ailureReason" type=" string" /> 
</sequence> 
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</complexType> 

<complexType name="BadCommentAlarmInf oRefList" > 

<sequence minOccurs="0" maxOccurs="unbounded" > 

< element name="listElement" type="alarmIRPData iBadCommentAlarmlnfoRef Element "/> 
</sequence> 
</complexType> 

<complexType name="BadUnacknowledgeAlarmInfoRef Element" > 
<sequence> 

<element ref ="xai : alarmId"/> 

<element name="f ailureReason" type="string"/> 
</sequence> 
</complexType> 

<complexType name="BadUnacknowledgeAlarmInfoRefList" > 
<sequence minOccurs="0" maxOccurs= "unbounded" > 
<element name="listElement" 
type= " alarmlRPData : BadUnacknowledgeAlarmlnfoRef Element " / > 
</sequence> 
</complexType> 

<simpleType name="FailureReasonBadAck" > 
<restriction base="string" > 

< enumeration value="UnknownAlarmId"/> 
<enumeration value="AcknowledgmentFailed"/> 
<enumeration value="WrongPerceivedSeverity"/> 
< /restrict ion> 
</simpleType> 

<simpleType name="OperationStatusTwo" > 
<restriction base="string" > 

< enumeration value="OperationSucceeded"/> 
< enumeration value="OperationFailed"/> 
</restriction> 
</simpleType> 

<simpleType name="OperationStatusThree" > 
<restriction base="string" > 

< enumeration value="OperationSucceeded"/> 
< enumeration value="OperationFailed"/> 
< enumeration value="OperationPartiallySucceeded"/> 
< /restrict ion> 
</simpleType> 

<!-- acknowledgeAlarms Request- -> 
<element name=" acknowledgeAlarms" > 
<complexType> 
<sequence> 

<element name="alarmlnf ormationAndSeverityRef erenceList" 
type= "alarmlRPData : AlarmldAndSeverityList " / > 

<element ref ="xai : ackUserId"/> 

<element ref ="xai : ackSystemId" minOccurs=" 0"/> 
</sequence> 
</complexType> 
</element> 

<!-- acknowledgeAlarms Response --> 
<element name="acknowledgeAlarmsResponse" > 
<complexType> 
<sequence> 

< element name="badAlarmInformationRef erenceList" 
type= " alarmlRPData : BadAcknowledgeAlarmInf oRef List " / > 

<element name=" status" type=" alarmlRPData :OperationStatusThree"/> 
</sequence> 
</complexType> 
</element> 

<!-- acknowledgeAlarms Fault --> 
<element name="acknowledgeAlarmsFault" > 
<simpleType> 

<restriction base="string" > 

< enumeration value="OperationFailed"/> 
</restriction> 
</simpleType> 
</element> 

<!-- getAlarmList Request --> 
<element name="getAlarmList" > 
< c omp 1 exTyp e > 
<sequence> 

<element name="alarmAckState" type=" alarmlRPData lAlarmAckState" 
minOccurs= " " /> 

<element name="baseObjectClass" type="string" minOccurs=" 0"/> 
<element name="baseObjectInstance" type="xn:dn" minOccurs="0"/> 
<element name="f liter" type="string" minOccurs=" 0"/> 
</sequence> 
</complexType> 
</element> 

<!-- getAlarmList Response --> 
<element name="getAlarmListResponse" > 
<complexType> 
<sequence> 

<element name="alarmInformationList" 
type= " alarmlRPData : Alarmlnf ormat ionList " / > 

< element name=" status" type=" alarmlRPData : Operations tatusTwo"/> 
</sequence> 
</complexType> 
</element> 
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<!-- getAlarmList Fault --> 
<element name="getAlarmListFault" > 
<simpleType> 

<restriction base="string" > 

< enumeration value="OperationFailed"/> 
< enumeration value="FilterComplexityLimit"/> 
< /restrict ion> 
</simpleType> 
</element> 

<!-- getAlarmCount Request --> 
<element name="getAlarmCount" > 
< c omp 1 exTyp e > 
<sequence> 

<element name="f ilter" type="string" minOccurs=" 0"/> 
<element name="alarmAckState" type="alarmIRPData lAlarmAckState" 
minOccurs= " " / > 

</sequence> 
</complexType> 
</element> 

<!-- getAlarmCount Response --> 
<element name="getAlarmCountResponse" > 
<complexType> 
<sequence> 

<element name="criticalCount" type="nonNegativeInteger"/> 
<element name="majorCount" type="nonNegativeInteger"/> 
<element name="minorCount" type="nonNegativeInteger"/> 
<element name="warningCount" type="nonNegativeInteger"/> 
< element name="indeterminateCount" type="nonNegativeInteger"/> 
<element name="clearedCount" type="nonNegativeInteger"/> 
< element name=" status" type="alarmIRPData : Operations tatusTwo"/> 
</sequence> 
</complexType> 
</element> 

<!-- getAlarmCount Fault --> 
<element name="getAlarmCountFault" > 
<simpleType> 

<restriction base="string" > 

< enumeration value="OperationFailed"/> 
< enumeration value="FilterComplexityLimit"/> 
</restriction> 
</simpleType> 
</element> 

<!-- unacknowledgeAlarms Request --> 
<element name="unacknowledgeAlarms" > 
< c omp 1 exTyp e > 
<sequence> 

<element name="alarmInformationRef erenceList" 
type= " alarmlRPData : AlarmldList " / > 

<element ref ="xai : ackUserId"/> 

<element ref ="xai : ackSystemId" minOccurs=" 0"/> 
</sequence> 
</complexType> 
</element> 

<!-- unacknowledgeAlarms Response --> 
<element name="unacknowledgeAlarmsResponse" > 
<complexType> 
<sequence> 

<element name="badAlarmInformationRef erenceList" 
type= " alarmlRPData : BadUnacknowledgeAlarmInf oRef List " / > 

< element name=" status" type=" alarmlRPData : Operations tatusThree"/> 
</sequence> 
</complexType> 
</element> 

<!-- unacknowledgeAlarms Fault --> 
<element name="unacknowledgeAlarmsFault" > 
<simpleType> 

<restriction base="string" > 

< enumeration value="OperationFailed"/> 
< /restrict ion> 
</simpleType> 
</element> 

<!-- setComment Request --> 
<element name= " setComment " > 
<complexType> 
<sequence> 

<element name="alarmInformationRef erenceList" 
type= " alarmlRPData : AlarmldList " / > 

<element ref ="xai :commentUserId"/> 

<element ref ="xai : commentSystemId" minOccurs="0"/> 
<element ref ="xai : commentText"/> 
</sequence> 
</complexType> 
</element> 

<!-- setComment Response --> 
<element name="setCommentResponse" > 
<complexType> 
<sequence> 

< element name="badAlarmInformationRef erenceList" 
type=" alarmlRPData iBadCommentAlarmlnfoRef List "/> 
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< element name= " status " type= " alarmlRPData : Operations tatusThree " / > 
</sequence> 
</complexType> 
</element> 

<!-- setComment Fault --> 
<element name="setCommentFault" > 
<simpleType> 

<restriction base="string"> 

<enumeration value="OperationFailed"/> 
< /restrict ion> 
</simpleType> 
</element> 

<!-- clearAlarms Request- -> 
<element name="clearAlarms"> 
<complexType> 
<sequence> 

<element name="alarmInformationRef erenceList" 
type= " alarmlRPData : AlarmldList " / > 

< element ref ="xai : clearUserId"/> 

<element ref ="xai : clearSystemId" minOccurs=" 0"/> 
</sequence> 
</complexType> 
</element> 

<!-- clearAlarms Response- -> 
<element name="clearAlarmsResponse" > 
<complexType> 
<sequence> 

<element name="badAlarmInformationRef erenceList" 
type=" alarmlRPData iBadClearAlarmlnfoRef List "/> 

< element name=" status" type=" alarmlRPData : Operations tatusThree"/> 
</sequence> 
</complexType> 
</element> 

<!-- clearAlarms Fault- -> 
<element name="clearAlarmsFault" > 
<simpleType> 

<restriction base="string" > 

< enumeration value="OperationFailed"/> 
< /restrict ion> 
</simpleType> 
</element> 
</schema> 
</types> 
<message name="acknowledgeAlarms" > 

<part name= "parameter" element=" alarmlRPData : acknowledgeAlarms"/> 
</message> 
<message name="acknowledgeAlarmsResponse" > 

<part name= "parameter" element=" alarmlRPData : acknowledgeAlarmsResponse"/> 
</message> 
<message name="acknowledgeAlarmsFault" > 

<part name= "parameter" element=" alarmlRPData : acknowledgeAlarmsFault"/> 
</message> 
<message name="getAlarmList" > 

<part name= "parameter" element=" alarmlRPData :getAlarmList"/> 
</message> 
<message name="getAlarmListResponse" > 

<part name= "parameter" element=" alarmlRPData :getAlarmListResponse"/> 
</message> 
<message name="getAlarmListFault" > 

<part name= "parameter" element=" alarmlRPData :getAlarmListFault"/> 
</message> 
<message name="getAlarmCount" > 

<part name= "parameter" element=" alarmlRPData :getAlarmCount"/> 
</message> 
<message name="getAlarmCountResponse" > 

<part name= "parameter" element=" alarmlRPData :getAlarmCountResponse"/> 
</message> 
<message name="getAlarmCountFault" > 

<part name= "parameter" element=" alarmlRPData :getAlarmCountFault"/> 
</message> 
<message name="unacknowledgeAlarms" > 

<part name= "parameter" element=" alarmlRPData :unacknowledgeAlarms"/> 
</message> 
<message name="unacknowledgeAlarmsResponse" > 

<part name= "parameter" element=" alarmlRPData :unacknowledgeAlarmsResponse"/> 
</message> 
<message name="unacknowledgeAlarmsFault" > 

<part name= "parameter" element=" alarmlRPData :unacknowledgeAlarmsFault"/> 
</message> 
<message name= " setComment " > 

<part name= "parameter" element="alarmIRPData : setComment "/> 
</message> 
<message name="setCommentResponse" > 

<part name= "parameter" element=" alarmlRPData : setCommentResponse"/> 
</message> 
<message name="setCommentFault" > 

<part name= "parameter" element=" alarmlRPData : setCommentFault"/> 
</message> 
<message name= " clearAlarms " > 
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<part name= "parameter" element="alarmIRPData : clearAlarms"/> 
</message> 
<message name="clearAlarmsResponse" > 

<part name= "parameter" element="alarmIRPData : clearAlarmsResponse"/> 
</message> 
<message name="clearAlarmsFault" > 

<part name= "parameter" element ="alarmIRPDat a : clearAlarmsFault"/> 
</message> 
<portType name="AlarmIRPPortType" > 

<operation name="acknowledgeAlarms" > 

< input message = " alarmlRPSystem : acknowledgeAlarms " / > 
<output message= " alarmlRPSystem : acknowledgeAlarmsResponse " / > 

< fault name= " acknowledgeAlarmsFault " message= " alarmlRPSystem : acknowledgeAlarmsFault " / > 
</operation> 
<operation name="getAlarmList" > 

< input message="alarmIRPSystem:getAlarmList"/> 
<output message="alarmIRPSystem:getAlarmListResponse"/> 

< fault name= " get AlarmList Fault " message= " alarmlRPSystem : getAlarmList Fault " / > 
</operation> 
<operation name="getAlarmCount" > 

< input message= " alarmlRPSystem : getAlarmCount " / > 
< output message="alarmIRPSystem:getAlarmCountResponse"/> 

< fault name = " getAlarmCount Fault " message = " alarmlRPSystem : getAlarmCount Fault " / > 
</operation> 
<operation name="unacknowledgeAlarms" > 

< input message= " alarmlRPSystem : unacknowledgeAlarms " / > 
<output message= " alarmlRPSystem : unacknowledgeAlarmsResponse " / > 
< fault name="unacknowledgeAlarmsFault" 
message=" alarmlRPSystem :unacknowledgeAlarmsFault"/> 
</operation> 
<operation name="setComment" > 

< input message=" alarmlRPSystem: set Comment "/> 
<output message=" alarmlRPSystem: setCommentResponse"/> 

< fault name = " set Comment Fault " message= " alarmlRPSystem : set Comment Fault " / > 
</operation> 
<operation name="clearAlarms" > 

< input message=" alarmlRPSystem: clearAlarms"/> 
<output message=" alarmlRPSystem: clearAlarmsResponse"/> 

< fault name="clearAlarmsFault" message=" alarmlRPSystem: clearAlarmsFault"/> 
</operation> 
</portType> 
<binding name="AlarmIRPBinding" type=" alarmlRPSystem :AlarmIRPPortType" > 

<soap : binding style=" document" transport ="http : //schemas .xmlsoap . org/soap/http"/> 
<operation name=" acknowledgeAlarms" > 

<soap : operation soapAction="http : //www. 3gpp .org/f tp/specs/archive/32_series/32 .111- 
G#acknowledgeAlarms" style= "document "/> 
< input > 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
</ output > 
< fault name=" acknowledgeAlarmsFault" > 

<soap:fault name=" acknowledgeAlarmsFault" use="literal"/> 
</fault> 
</operation> 
<operation name="getAlarmList" > 

<soap : operation soapAction="http : //www. 3gpp . org/f tp/ specs/archive/ 32_series/ 32 .111- 
6#getAlarmList" style=" document "/> 
< input > 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
< /output > 
<f ault name="getAlarmListFault" > 

<soap:fault name="getAlarmListFault" use="literal"/> 
</fault> 
</operation> 
<operation name=" getAlarmCount" > 

<soap : operation soapAction="http : //www. 3gpp .org/f tp/specs/archive/32_series/32 .111- 
6#getAlarmCount " style= " document " / > 
< input > 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
< /output > 
<f ault name="getAlarmCountFault" > 

<soap:fault name="getAlarmCountFault" use="literal"/> 
</fault> 
</operation> 
<operation name=" unacknowledgeAlarms" > 

<soap : operation soapAction="http : //www. 3gpp .org/f tp/ specs/archive/ 32_series/ 32 .111- 
6#unacknowledgeAlarms" style= "document "/> 
< input > 

<soap:body use="literal"/> 
</ input > 
<output> 
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<soap:body use="literal"/> 
< /output > 
< fault name="unacknowledgeAlarmsFault" > 

<soap:fault name="unacknowledgeAlarmsFault" use="literal"/> 
</fault> 
</operation> 
<operation name="setComment" > 

<soap : operation soapAction="http : //www. 3gpp .org/f tp/specs/archive/32_series/32 .111- 
6 # set Comment" style= "document "/> 
< input > 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
< /output > 
<fault name="setCommentFault" > 

<soap:fault name="setCommentFault" use="literal"/> 
</fault> 
</operation> 
<operation name="clearAlarms" > 

<soap : operation soapAction="http : //www. 3gpp .org/f tp/ specs/archive/ 32_series/ 32 .111- 
6#clearAlarms" style= "document "/> 
< input > 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
< /output > 
<f ault name="clearAlarmsFault" > 

<soap:fault name="clearAlarmsFault" use="literal"/> 
</f ault> 
</operation> 
</binding> 
<service name="AlarmIRPService" > 

<port name= " AlarmlRPPort " binding= " alarmlRPSystem : AlarmlRPBinding" > 

<soap : address location="http : //www. 3gpp .org/f tp/ specs/archive/ 32_series/32 .111- 
6#AlarmIRP"/> 

</port> 

<port name =" Generic IRPPort" binding="genericIRPSystem:GenericIRPBinding"> 
<soap : address 
location="http : //www. 3gpp . org/f tp/ specs/archive/ 32_series/ 32 . 316#GenericIRP"/> 
</port> 

<port name="Notif icationlRPNtf Port" binding="ntf IRPNtf SystemiNotif icationlRPNtf " > 
<soap : address 
location="http : //www. 3gpp .org/f tp/specs/archive/32_series/32 . 306#Notif icationlRPNtf "/> 
</port> 
</service> 
</def initions> 
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